**Hinweis zum Ende des Supports:** Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter [Ende des Amazon-Pinpoint-Supports](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Hinweis:** APIs In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Tutorial: Verwenden von Postman mit der Amazon-Pinpoint-API Postman ist ein beliebtes Tool zum Testen APIs in einer easy-to-use grafischen Umgebung. Sie können mit Postman API-Anfragen an eine REST-API senden und Antworten auf Ihre Anfragen empfangen. Postman bietet eine bequeme Möglichkeit, die Aufrufe an die Amazon-Pinpoint-API zu testen und Fehler zu beheben. Dieses Tutorial behandelt Verfahren zur Einrichtung und Verwendung von Postman mit Amazon Pinpoint. **Anmerkung** Postman wird von einem Drittanbieter entwickelt. Es wird von Amazon Web Services (AWS) nicht entwickelt oder unterstützt. Weitere Informationen zur Verwendung von Postman oder Hilfe bei Problemen im Zusammenhang mit Postman erhalten Sie im [Support Center](https://support.postman.com/hc/en-us) auf der Postman-Website. ## Über dieses Tutorial Dieser Abschnitt enthält einen Überblick über dieses Tutorial. **Zielgruppe** Dieses Tutorial richtet sich an Entwickler und Systemimplementierer. Sie müssen nicht mit Amazon Pinpoint oder Postman vertraut sein, um die Schritte in diesem Tutorial ausführen zu können. Sie sollten mit der Verwaltung von IAM-Richtlinien und der Änderung von JSON-Codebeispielen vertraut sein. Die Verfahren in diesem Tutorial wurden entwickelt, um zu verhindern, dass neue Benutzer API-Operationen verwenden, die Amazon-Pinpoint-Ressourcen dauerhaft löschen können. Fortgeschrittene Benutzer können diese Einschränkung aufheben, indem sie die Richtlinie ändern, die ihren -Benutzern zugeordnet ist. **Verwendete Funktionen** Dieses Tutorial enthält Anwendungsbeispiele für das folgende Amazon-Pinpoint-Feature: + Interaktion mit der Amazon-Pinpoint-API mithilfe von Postman **Benötigte Zeit** Es sollte etwa 15 Minuten dauern, bis Sie dieses Tutorial abgeschlossen haben. **Regionale Einschränkungen** Es sind keine regionalen Einschränkungen mit der Nutzung dieser Lösung verbunden. **Kosten der Ressourcennutzung** Die Erstellung eines AWS Kontos ist kostenlos. Durch die Implementierung dieser Lösung können Ihnen jedoch AWS Nutzungskosten entstehen, wenn Sie Postman für eine der folgenden Aufgaben verwenden: + Senden von Nachrichten per E-Mail, SMS, Mobile Push oder Voice + Erstellen und Senden von Kampagnen + Verwenden der Funktion zur Telefonnummernüberprüfung Weitere Informationen zu den Gebühren, die mit der Nutzung von Amazon Pinpoint verbunden sind, finden Sie unter [Amazon Pinpoint – Preise](https://aws.amazon.com/pinpoint/pricing/). # Voraussetzungen für die Verwendung von Postman mit Amazon Pinpoint Bevor Sie mit diesem Tutorial beginnen, müssen Sie die folgenden Voraussetzungen erfüllen: + Sie müssen ein AWS Konto haben. Um ein AWS Konto zu erstellen, gehen Sie zu [https://console.aws.amazon.com/](https://console.aws.amazon.com/)und wählen Sie **Neues AWS Konto erstellen**. + Stellen Sie sicher, dass das Konto, mit dem Sie sich anmelden, neue IAM-Richtlinien und -Rollen erstellen AWS-Managementkonsole kann. + Stellen Sie sicher, dass Sie mindestens ein Beispielprojekt erstellt haben, für das E-Mail aktiviert ist und für das eine verifizierte E-Mail-Identität vorliegt. Weitere Informationen finden Sie unter [Erstellen eines Amazon-Pinpoint-Projekts mit E-Mail-Unterstützung](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) im *Amazon-Pinpoint-Benutzerhandbuch*. + Stellen Sie sicher, dass Sie eine AWS Konto-ID haben. Ihre AWS Konto-ID finden Sie in der oberen rechten Ecke der Konsole oder Sie können die Befehlszeilenschnittstelle (CLI) verwenden. Weitere Informationen findest du unter [Deine AWS Konto-ID finden](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). + Sie müssen Postman herunterladen und auf Ihrem Computer installieren. Sie können Postman von der [Postman-Website](https://www.getpostman.com) herunterladen. + Nachdem Sie Postman auf Ihrem Computer installiert haben, müssen Sie ein Postman-Konto erstellen. Wenn Sie die Postman-Anwendung zum ersten Mal starten, werden Sie aufgefordert, sich anzumelden oder ein neues Konto zu erstellen. Folgen Sie den Anweisungen von Postman, um sich bei Ihrem Konto anzumelden oder ein Konto zu erstellen, sofern Sie noch kein Konto haben. **Weiter**: [Erstellen von IAM-Richtlinien und -Rollen](tutorials-using-postman-iam-user.md) # Erstellen Sie IAM-Richtlinien und -Rollen für die Verwendung mit Amazon Pinpoint Wenn Sie Postman verwenden, um die Amazon-Pinpoint-API zu testen, besteht der erste Schritt darin, einen Benutzer zu erstellen. In diesem Abschnitt erstellen Sie eine Richtlinie, die es Benutzern erlaubt, mit allen Amazon-Pinpoint-Ressourcen zu interagieren. Anschließend erstellen Sie einen Benutzer und fügen die Richtlinie direkt an den Benutzer an. ## Eine IAM-Richtlinie erstellen Erfahren Sie mehr dazu, wie Sie eine IAM-Richtlinie erstellen. Benutzer und Rollen, die diese Richtlinie verwenden, können mit allen Ressourcen in der Amazon-Pinpoint-API interagieren. Sie bietet auch Zugriff auf Ressourcen, die mit der Amazon-Pinpoint-E-Mail-API sowie der Amazon-Pinpoint-SMS- und Sprachnachrichten-API verknüpft sind. **So erstellen Sie die Richtlinie** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 1. Wählen Sie im Navigationsbereich **Richtlinien** und dann **Richtlinie erstellen**. 1. Wählen Sie im **Policy-Editor** **JSON** aus. Löschen Sie alle JSON-Dateien, die im **Richtlinieneditor** aktuell sind, sodass sie leer sind. Kopieren Sie den folgenden JSON-Code und fügen Sie ihn in den **Policy-Editor** ein. Ersetzen Sie dann im **Policy-Editor** alle Instanzen von *123456789012* durch Ihre AWS-Konto ID. Ihre AWS-Konto ID finden Sie in der oberen rechten Ecke der Konsole, oder Sie können die CLI verwenden, siehe [Ihre AWS Konto-ID finden](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). **Anmerkung** Zum Schutz der Daten in Ihrem Amazon-Pinpoint-Konto umfasst diese Richtlinie nur Berechtigungen, die Ihnen erlauben, Ressourcen zu lesen, zu erstellen und zu ändern. Sie beinhaltet nicht die Berechtigung, Ressourcen zu löschen. Sie können diese Richtlinie mithilfe des visuellen Editors in der IAM-Konsole ändern. Weitere Informationen finden Sie unter [Verwalten der IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) im IAM-Benutzerhandbuch. Sie können diese Richtlinie auch mithilfe des [CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)Vorgangs in der IAM-API aktualisieren. Diese Richtlinie umfasst auch Berechtigungen, die Ihnen erlauben, mit den Services `ses` und `sms-voice` zu interagieren, zusätzlich zum Service `mobiletargeting`. Die Berechtigungen `ses` und `sms-voice` ermöglichen Ihnen die Interaktion mit der Amazon-Pinpoint-E-Mail-API bzw. der Amazon-Pinpoint-SMS- und Sprachnachrichten-API. Die `mobiletargeting`-Berechtigungen ermöglichen Ihnen die Interaktion mit der Amazon-Pinpoint-API. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "mobiletargeting:Update*", "mobiletargeting:Get*", "mobiletargeting:Send*", "mobiletargeting:Put*", "mobiletargeting:Create*" ], "Resource": [ "arn:aws:mobiletargeting:*:123456789012:apps/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "mobiletargeting:TagResource", "mobiletargeting:PhoneNumberValidate", "mobiletargeting:ListTagsForResource", "mobiletargeting:CreateApp" ], "Resource": "arn:aws:mobiletargeting:*:123456789012:*" }, { "Sid": "VisualEditor2", "Effect": "Allow", "Action": [ "ses:TagResource", "ses:Send*", "ses:Create*", "ses:Get*", "ses:List*", "ses:Put*", "ses:Update*", "sms-voice:SendVoiceMessage", "sms-voice:List*", "sms-voice:Create*", "sms-voice:Get*", "sms-voice:Update*" ], "Resource": "*" } ] } ``` ------ Wählen Sie **Weiter** aus. 1. Geben Sie **unter Richtlinienname** einen Namen für die Richtlinie ein, z. B. **PostmanAccessPolicy** Wählen Sie **Richtlinie erstellen** aus. 1. (Optional) Sie können der Richtlinie Tags hinzufügen, indem Sie **Tag hinzufügen** auswählen. 1. Wählen Sie **Weiter: Prüfen** aus. ## Erstellen eines IAM-Benutzers **Warnung** IAM-Benutzer verfügen über langfristige Anmeldeinformationen, was ein Sicherheitsrisiko darstellt. Um dieses Risiko zu minimieren, empfehlen wir, diesen Benutzern nur die Berechtigungen zu gewähren, die sie für die Ausführung der Aufgabe benötigen, und diese Benutzer zu entfernen, wenn sie nicht mehr benötigt werden. Nachdem Sie die Richtlinie erstellt haben, können Sie einen Benutzer erstellen und die Richtlinie an diesen anhängen. Wenn Sie den Benutzer erstellen, stellt Ihnen IAM einen Satz von Anmeldeinformationen bereit, mit dem Sie Postman erlauben können, Amazon-Pinpoint-API-Operationen auszuführen. **So erstellen Sie den Benutzer** 1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole. 1. Wählen Sie auf der IAM-Konsole im Navigationsbereich **Benutzer** und dann **Benutzer erstellen** aus. 1. Geben Sie unter **Benutzerdetails** für **Benutzername** einen eindeutigen Namen für den Benutzer ein, z. B. **PostmanUser**. Klicken Sie anschließend auf **Weiter**. 1. Wählen Sie unter **Berechtigungen festlegen** für **Berechtigungsoptionen** die Option **Direktes Anfügen von Richtlinien** aus. 1. Wählen Sie unter **Berechtigungsrichtlinien** die Richtlinie (**PostmanAccessPolicy**) aus, die Sie unter [IAM-Richtlinie erstellen](#tutorials-using-postman-iam-user-create-policy) erstellt haben. Klicken Sie anschließend auf **Weiter**. 1. Auf der Seite **Prüfen und erstellen** können Sie optional Tags hinzufügen, um Benutzer leichter zu identifizieren. Weitere Informationen zur Verwendung von Tags finden Sie unter [Markieren von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *IAM-Benutzerhandbuch*. 1. Wenn Sie bereit sind, den Benutzer zu erstellen, wählen Sie **Create user (Benutzer erstellen)** aus. ## Zugriffsschlüssel erstellen **Warnung** Dieses Szenario erfordert IAM-Benutzer mit programmatischem Zugriff und langfristigen Anmeldeinformationen, was ein Sicherheitsrisiko darstellt. Um dieses Risiko zu minimieren, empfehlen wir, diesen Benutzern nur die Berechtigungen zu gewähren, die sie für die Ausführung der Aufgabe benötigen, und diese Benutzer zu entfernen, wenn sie nicht mehr benötigt werden. Die Zugriffsschlüssel können bei Bedarf aktualisiert werden. Weitere Informationen finden Sie unter [Zugriffsschlüssel aktualisieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html) im *IAM-Benutzerhandbuch*. IAM stellt einen Satz von Anmeldeinformationen bereit, mit dem Sie Postman erlauben können, Amazon-Pinpoint-API-Operationen auszuführen. **So erstellen Sie den Benutzer** 1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole. 1. Wählen Sie im Navigationsbereich der IAM-Konsole **Benutzer** aus. Wählen Sie den Benutzer (**PostmanUser**) aus, der unter [Einen IAM-Benutzer erstellen](#tutorials-using-postman-iam-user-create-user) erstellt wurde, und wählen Sie dann die Registerkarte **Sicherheitsanmeldeinformationen** aus. 1. Wählen Sie im Abschnitt **Zugriffsschlüssel** die Option **Zugriffsschlüssel erstellen** aus. 1. Wählen Sie auf der Seite **Zugriff auf die wichtigsten bewährten Methoden und Alternativen** die Option **Anwendung wird außerhalb AWS ausgeführt** aus. Klicken Sie anschließend auf **Weiter**. 1. (Optional) Sie können der Richtlinie ein Beschreibungs-Tag hinzufügen. 1. Wählen Sie **Zugriffsschlüssel erstellen** aus. 1. Kopieren Sie auf der Seite **Zugriffsschlüssel abrufen** die Anmeldeinformationen, die in den Spalten **Zugriffsschlüssel** und **Geheimer Zugriffsschlüssel** angezeigt werden. **Anmerkung** Sie müssen sowohl die Zugriffsschlüssel-ID als auch den geheimen Zugriffsschlüssel in einem späteren Schritt in diesem Tutorial angeben. Dies ist das einzige Mal, dass Sie den geheimen Zugriffsschlüssel anzeigen können. Wir empfehlen Ihnen, dass Sie ihn kopieren und an einem sicheren Ort speichern. 1. Nachdem Sie beide Schlüssel gespeichert haben, wählen Sie **Fertig** aus. **Nächster Schritt**: [Einrichten von Postman](tutorials-using-postman-configuration.md) # Postman für die Verwendung mit Amazon Pinpoint einrichten Nachdem Sie jetzt einen Benutzer erstellt haben, das auf die Amazon-Pinpoint-API zugreifen kann, können Sie Postman einrichten. In diesem Abschnitt erstellen Sie eine oder mehrere Umgebungen in Postman. Als nächstes importieren Sie eine Sammlung, die für jeden der Vorgänge in der Amazon-Pinpoint-API eine Vorlage für Anfragen enthält. ## Erstellen Sie einen Postman-Arbeitsbereich In Postman ist ein *Workspace* ein organisatorischer Container für Projekte und Umgebungen. In diesem Abschnitt erstellen Sie mindestens einen Workspace zur Verwendung mit Amazon Pinpoint. **Einen Workspace erstellen** Wählen Sie in Postman die weiteren Aktionen **Datei** und dann **Neu** aus. 1. Wählen Sie im Fenster **Neu erstellen** die Option **Workspace** aus. 1. Geben Sie einen Namen und eine Zusammenfassung ein und setzen Sie die Sichtbarkeit auf „Persönlich“. Wählen Sie dann **Workspace erstellen** aus. ## Erstellen Sie Postman-Umgebungen In Postman ist eine *Umgebung* ein Satz von Variablen, die als Schlüssel-Wert-Paare gespeichert werden. Sie können Umgebungen nutzen, um die Konfiguration der Anfragen, die Sie über Postman stellen, zu ändern, ohne die API-Anfragen selbst ändern zu müssen. In diesem Abschnitt erstellen Sie mindestens eine Umgebung, die Sie mit Amazon Pinpoint verwenden können. Jede Umgebung, die Sie erstellen, enthält einen Satz von Variablen, die spezifisch für Ihr Konto in einer einzigen AWS-Region sind. Wenn Sie die Verfahren in diesem Abschnitt verwenden, um mehr als eine Umgebung zu erstellen, können Sie zwischen den Regionen wechseln, indem Sie eine andere Umgebung aus dem Menü **Umgebung** in Postman auswählen. **So erstellen Sie eine Umgebung** 1. Wählen Sie in Postman die weiteren Aktionsmenüs **Datei** und dann **Neu** aus. 1. Wählen Sie im Fenster **Create New (Neu erstellen)** die Option **Environment (Umgebung)** aus. 1. Geben Sie im Fenster **MANAGE ENVIRONMENTS (Umgebungen verwalten)** unter **Environment Name (Name der Umgebung)** **Amazon Pinpoint - *Region Name*** ein. *Region Name*Ersetzen Sie durch einen der folgenden Werte: + USA Ost (Nord-Virginia) + USA West (Oregon) + Asien-Pazifik (Mumbai) + Asien-Pazifik (Sydney) + Europe (Frankfurt) + Europa (Irland) **Anmerkung** Sie müssen mindestens eine Umgebung für ein einzelnes Projekt erstellen AWS-Region, und diese AWS-Region muss ein Projekt enthalten. Wenn Sie kein Projekt in einem der zuvor aufgelisteten Projekte erstellt haben AWS-Regionen, finden Sie weitere Informationen unter [Erstellen eines Amazon Pinpoint Pinpoint-Projekts mit E-Mail-Support](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) im *Amazon Pinpoint Pinpoint-Benutzerhandbuch*. 1. Erstellen Sie sechs neue Variablen: `endpoint`, `region`, `serviceName`, `accountId`, `accessKey` und `secretAccessKey`. Verwenden Sie die folgende Tabelle, um zu bestimmen, welcher Wert in die Spalten **Anfangswert** und **Aktueller Wert** für jede Variable eingegeben werden soll. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/tutorials-using-postman-configuration.html) Nachdem Sie diese Variablen erstellt haben, ähnelt das Fenster **MANAGE ENVIRONMENTS (Umgebungen verwalten)** dem Beispiel in der folgenden Abbildung. ![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png) Wählen Sie **Save (Speichern)** aus, wenn Sie fertig sind. **Wichtig** Die Zugriffsschlüssel in der vorhergehenden Abbildung sind fiktiv. Geben Sie Ihre IAM-Zugriffsschlüssel nicht an andere weiter. Postman enthält Features, mit denen Sie Umgebungen gemeinsam nutzen und exportieren können. Wenn Sie diese Features verwenden, achten Sie darauf, dass Sie Ihre Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel nicht an Personen weitergeben, die keinen Zugriff auf diese Zugangsdaten haben dürfen. Weitere Informationen finden Sie unter [Bewährte Methoden für IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) im *IAM-Benutzerhandbuch*. 1. (Optional) Wiederholen Sie die Schritte 1–4 für jede weitere Umgebung, die Sie erstellen möchten. **Tipp** In Postman können Sie so viele Umgebungen erstellen, wie Sie benötigen. Sie können Umgebungen auf folgende Weisen verwenden: Erstellen Sie eine separate Umgebung für jede Region, in der Sie die Amazon-Pinpoint-API testen müssen. Erstellen Sie Umgebungen, die mit verschiedenen AWS-Konten verknüpft sind. Erstellen Sie Umgebungen, die Anmeldeinformationen verwenden, die mit anderen Benutzern verknüpft sind. 1. Wenn Sie mit der Erstellung von Umgebungen fertig sind, fahren Sie mit dem nächsten Abschnitt fort. ## Erstellen Sie eine Amazon Pinpoint-Sammlung in Postman In Postman ist eine *Sammlung* eine Gruppe von API-Anforderungen. Anfragen in einer Sammlung werden in der Regel durch einen gemeinsamen Zweck zusammengefasst. In diesem Abschnitt erstellen Sie eine neue Sammlung, die für jeden Vorgang in der Amazon-Pinpoint-API eine Vorlage für Anfragen enthält. **So erstellen Sie die Amazon Pinpoint-Sammlung** 1. Wählen Sie in Postman die weiteren Aktionsmenüs **Datei** und dann **Importieren** aus. 1. Wählen Sie im Fenster **Import** die Option **Aus Link importieren** und geben Sie dann die folgende URL ein: [https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json) %20pinpoint.postman\$1collection.json. Wählen Sie **Importieren** aus. Postman importiert die Amazon-Pinpoint-Sammlung, die 120 Beispielanfragen enthält. ## Testen Ihrer Postman-Konfiguration Nachdem Sie die Amazon-Pinpoint-Sammlung importiert haben, sollten Sie einen schnellen Test durchführen, um sicherzustellen, dass alle Komponenten richtig konfiguriert sind. Sie können Ihre Konfiguration testen, indem Sie eine `GetApps`-Anfrage senden. Diese Anfrage gibt eine Liste aller Projekte zurück, die in Ihrem Amazon-Pinpoint-Konto in der aktuellen AWS-Region-Region existieren. Diese Anfrage erfordert keine zusätzliche Konfiguration, daher ist es eine gute Möglichkeit, Ihre Konfiguration zu testen. **So testen Sie die Konfiguration der Amazon-Pinpoint-Sammlung** 1. Wählen Sie im linken Navigationsbereich **Sammlungen** aus, erweitern Sie die **Amazon-Pinpoint**-Sammlung und erweitern Sie den **Apps**-Ordner. 1. **GetApps**Wählen Sie in der Liste der Anfragen. 1. Verwenden Sie die **Umgebungsauswahl**, um die Umgebung auszuwählen, die Sie in [Create Postman-Umgebungen](#tutorials-using-postman-configuration-create-environments) erstellt haben. 1. Wählen Sie **Send (Senden)** aus. Wenn die Anfrage erfolgreich gesendet wurde, zeigt der Antwortbereich den Status `200 OK` an. Sie sehen eine Antwort, die dem Beispiel in der folgenden Abbildung ähnelt. ![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png) **Anmerkung** Wenn Sie keine Projekte in der erstellt haben, AWS-Region kehrt Amazon Pinpoint zurück`{ "Item": [] }`. Diese Antwort zeigt eine Liste aller Amazon-Pinpoint-Projekte, die in Ihrem Konto in der Region existieren, die Sie in Schritt 3 ausgewählt haben. ### Fehlerbehebung Wenn Sie Ihre Anfrage absenden, wird möglicherweise ein Fehler angezeigt. In der folgenden Liste finden Sie einige Fehler, die häufig auftreten können, und Hinweise auf Schritte, die Sie zur Behebung dieser Fehler ergreifen können. | Fehlermeldung | Problem | Auflösung | | --- | --- | --- | | Could not get any response (Konnte keine Antwort erhalten) Beim Herstellen einer Verbindung zu https://%7B%7Bendpoint%7D%7 D/v1/apps ist ein Fehler aufgetreten. | Es gibt keinen aktuellen Wert für die Variable `{{endpoint}}`, die gesetzt wird, wenn Sie eine Umgebung auswählen. | Verwenden Sie das Umgebungsauswahlfeld zur Auswahl einer Umgebung. | | Das Sicherheits-Token der Anfrage ist ungültig. | Postman konnte den aktuellen Wert Ihrer Zugriffsschlüssel-ID oder Ihres geheimen Zugriffsschlüssels nicht finden. | Wählen Sie das Zahnradsymbol neben dem Umgebungsauswahlfeld aus und wählen Sie dann die aktuelle Umgebung aus. Stellen Sie sicher, dass die Werte `accessKey` und `secretAccessKey` sowohl in den Spalten **ANFANGSWERT** als auch **AKTUELLER WERT** angezeigt werden und dass Sie die Anmeldeinformationen korrekt eingegeben haben. | | „Message“: „Der Benutzer: arn:aws:iam: :123456789012:user/ PinpointPostmanUser ist nicht berechtigt, Folgendes auszuführen: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012: \$1“ GetApps | Die IAM-Richtlinie, die Ihrem Benutzer zugeordnet ist, enthält nicht die entsprechenden Berechtigungen. | [[Vergewissern Sie sich, dass Ihr Benutzer über die unter Erstellen einer IAM-Richtlinie beschriebenen Berechtigungen verfügt und dass Sie die richtigen Anmeldeinformationen angegeben haben, als Sie die Umgebung im Arbeitsbereich Postman erstellen erstellt haben.](#tutorials-using-postman-configuration-create-environments)](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy) | **Nächster Schritt**: [Senden von zusätzlichen Anforderungen](tutorials-using-postman-sample-requests.md) # Anfragen an die Amazon Pinpoint API senden Wenn Sie die Konfiguration und den Test von Postman abgeschlossen haben, können Sie zusätzliche Anfragen an die Amazon-Pinpoint-API senden. Dieser Abschnitt enthält Informationen, die Sie kennen müssen, bevor Sie mit dem Senden von Anfragen beginnen. Es enthält auch zwei Beispielanfragen, in denen beschrieben wird, wie die Amazon-Pinpoint-Sammlung verwendet wird. **Wichtig** Wenn Sie die in diesem Abschnitt beschriebenen Schritte ausführen, senden Sie Anfragen an die Amazon-Pinpoint-API. Diese Anfragen können neue Ressourcen in Ihrem Amazon-Pinpoint-Konto erstellen, bestehende Ressourcen ändern, Nachrichten senden, die Konfiguration Ihrer Amazon-Pinpoint-Projekte ändern und andere Amazon-Pinpoint-Features nutzen. Seien Sie vorsichtig, wenn Sie diese Anfragen ausführen. ## Beispiele aus der Amazon Pinpoint Postman-Kollektion Sie müssen die meisten Operationen in der Amazon-Pinpoint-Postman-Sammlung konfigurieren, bevor Sie sie verwenden können. Für `GET`- und `DELETE`-Operationen müssen Sie in der Regel nur die Variablen ändern, die auf der Registerkarte **Pre-Request Script (Skript vor Anfrage)** eingestellt sind. **Anmerkung** Wenn Sie die IAM-Richtlinie verwenden, die unter [Eine IAM-Richtlinie erstellen](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy) aufgeführt ist, können Sie keine der in dieser Sammlung enthaltenen `DELETE` Anfragen ausführen. Beispielsweise erfordert die Operation `GetCampaign` die Angabe einer `projectId` und einer `campaignId`. Auf der Registerkarte **Pre-Request Script (Skript vor Anfrage)** sind beide Variablen vorhanden und mit Beispielwerten ausgefüllt. Löschen Sie die Beispielwerte und ersetzen Sie sie durch die Werte für Ihr Amazon-Pinpoint-Projekt und Ihre Kampagne. Von diesen Variablen wird die `projectId`-Variable am häufigsten verwendet. Der Wert für diese Variable ist ein eindeutiger Bezeichner für das Projekt, für das Ihre Anforderung gilt. Eine Liste mit Bezeichnern für Ihre Projekte finden Sie in der Antwort auf die `GetApps`-Anforderung, die Sie im vorherigen Schritt dieser Anleitung gesendet haben. In dieser Antwort enthält das `Id`-Feld die eindeutige Kennung für ein Projekt. Weitere Informationen zur `GetApps`-Operation und zur Bedeutung der einzelnen Felder in der Antwort finden Sie unter [Apps](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) in der *Amazon-Pinpoint-API-Referenz*. **Anmerkung** In Amazon Pinpoint ist ein „Projekt“ dasselbe wie eine „App“ oder „Anwendung“. Für `POST`- und `PUT`-Operationen müssen Sie auch den Anfragetext so anpassen, dass er die Werte enthält, die Sie an die API senden möchten. Wenn Sie beispielsweise eine `CreateApp`-Anforderung senden (bei der es sich um eine `POST`-Anforderung handelt), müssen Sie einen Namen für das Projekt angeben, das Sie erstellen. Sie können die Anfrage auf der Registerkarte **Body (Text)** ändern. Ersetzen Sie in diesem Beispiel den Wert neben `"Name"` durch den Namen des Projekts. Wenn Sie dem Projekt Tags hinzufügen möchten, können Sie diese im `tags`-Objekt angeben. Oder, wenn Sie keine Tags hinzufügen möchten, können Sie das gesamte `tags`-Objekt löschen. **Anmerkung** Für die Operation `UntagResource` müssen Sie außerdem URL-Parameter angeben. Sie können diese Parameter auf der Registerkarte **Params (Parameter)** angeben. Ersetzen Sie die Werte in der Spalte **VALUE (Wert)** durch die Tags, die Sie für die angegebene Ressource löschen möchten. ## Beispielanfrage: Erstellen Sie ein Projekt mithilfe des Vorgangs `CreateApp` Bevor Sie Segmente und Kampagnen in Amazon Pinpoint erstellen, müssen Sie zunächst ein Projekt erstellen. In Amazon Pinpoint besteht ein *Projekt* aus Segmenten, Kampagnen, Konfigurationen und Daten, die durch einen gemeinsamen Zweck miteinander verbunden sind. Beispielsweise könnten Sie in einem Projekt alle Inhalte vereinen, die sich auf eine bestimmte App oder eine bestimmte Marke oder Marketinginitiative beziehen. Wenn Sie Kundeninformationen zu Amazon Pinpoint hinzufügen, werden diese Informationen einem Projekt zugeordnet. **Um ein Projekt durch Senden einer CreateApp API-Anfrage zu erstellen** 1. Wählen Sie im Menü **Umgebungen** die aus AWS-Region , in der Sie das Projekt erstellen möchten. ![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) In diesem Beispiel wurde Postman so konfiguriert, dass das Menü **Environments (Umgebungen)** die folgenden vier Optionen anzeigt: + USA Ost (Nord-Virginia) + USA West (Oregon) + Europe (Frankfurt) + Europa (Irland) 1. Wählen Sie im Ordner **Apps** den **CreateApp**Vorgang > aus. ![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) Der **Apps**-Ordner in der Amazon-Pinpoint-Postman-Sammlung ist erweitert und enthält die folgenden Anfragen: + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. Ersetzen Sie auf der Registerkarte **Body (Text)**, neben `"Name"`, den Platzhalterwert (`"string"`) durch einen Namen für die Kampagne, z. B. **"MySampleProject"**. 1. Löschen Sie das Komma, das nach dem Kampagnennamen steht, und löschen Sie dann das gesamte `tags`-Objekt in den Zeilen 3 bis 5. Wenn Sie fertig sind, sollte Ihre Anfrage dem Beispiel ähneln, das im folgenden Code-Snippet gezeigt wird. ``` { "Name": "MySampleProject" } ``` Postman ist so konfiguriert, dass die Anfrage als unformatierte JSON-Nutzlast gesendet wird. 1. Wählen Sie **Send (Senden)** aus. Wenn die Kampagne erfolgreich erstellt wurde, zeigt der Antwortbereich den Status `201 Created` an. ``` { "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} } ``` ## Beispiel: Senden Sie eine E-Mail mithilfe des Vorgangs `SendMessages` Es ist sehr verbreitet, die Amazon-Pinpoint–`SendMessages`API zu verwenden, um transaktionale Nachrichten zu senden. Ein Vorteil des Sendens von Nachrichten über die `SendMessages`-API (im Gegensatz zum Erstellen von Kampagnen) besteht darin, dass Sie Nachrichten an eine beliebige Adresse senden können (z. B. E-Mail-Adresse, Telefonnummer oder Geräte-Token). Die Adresse, an die Sie Nachrichten senden, muss in Ihrem Amazon-Pinpoint -Konto nicht bereits vorhanden sein. Vergleichen wir dies mit dem Versenden von Nachrichten durch das Erstellen von Kampagnen. Bevor Sie eine Kampagne in Amazon Pinpoint versenden, müssen Sie Ihrem Amazon-Pinpoint-Konto Endpunkte hinzufügen, Segmente erstellen, die Kampagne erstellen und die Kampagne durchführen. Das Beispiel in diesem Abschnitt zeigt, wie Sie eine transaktionale E-Mail-Nachricht direkt an eine bestimmte E-Mail-Adresse senden können. Sie können diese Anfrage ändern, um Nachrichten über andere Kanäle wie SMS, Mobile Push oder Voice zu senden. **Um eine E-Mail-Nachricht zu senden, indem Sie eine SendMessages Anfrage einreichen** 1. Stellen Sie sicher, dass der E-Mail-Kanal für das Projekt aktiviert ist und dass die E-Mail-Adresse oder Domain, die Sie zum Senden und Empfangen der Nachricht verwenden möchten, konfiguriert ist. Weitere Informationen finden Sie unter [Aktivieren und Deaktivieren des E-Mail-Kanals](pinpoint/latest/userguide/channels-email-setup.html) und [Verifizieren von E-Mail-Identitäten](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) im *Amazon-Pinpoint-Benutzerhandbuch*. **Anmerkung** Um das Verfahren in diesem Abschnitt abzuschließen, müssen Sie eine E-Mail-Adresse verifizieren. 1. Wählen Sie im Menü **Umgebungen** die Umgebung aus AWS-Region , von der aus Sie die Nachricht senden möchten. In diesem Beispiel wurde Postman so konfiguriert, dass das Menü **Environments (Umgebungen)** die folgenden vier Optionen anzeigt: + USA Ost (Nord-Virginia) + USA West (Oregon) + Europe (Frankfurt) + Europa (Irland) 1. Wählen Sie im Ordner **Nachrichten** den **SendMessages**Vorgang aus. ![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. Ersetzen Sie auf der Registerkarte **Pre-Request Script (Skript vor Anfrage)** den Wert der Variablen `projectId` durch die ID eines Projekts, das bereits in der Region existiert, die Sie in Schritt 2 dieses Abschnitts ausgewählt haben. 1. Löschen Sie auf der Registerkarte **Body (Text)** die Beispielanfrage, die im Anfrage-Editor angezeigt wird. Fügen Sie folgenden Code ein: ``` { "MessageConfiguration":{ "EmailMessage":{ "FromAddress":"sender@example.com", "SimpleEmail":{ "Subject":{ "Data":"Sample Amazon Pinpoint message" }, "HtmlPart":{ "Data":"

Test message

This is a sample message sent from Amazon Pinpoint using the SendMessages API.

" }, "TextPart":{ "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API." } } } }, "Addresses":{ "recipient@example.com": { "ChannelType": "EMAIL" } } } ``` 1. Ersetzen Sie den Code im vorherigen Code *sender@example.com* durch Ihre verifizierte E-Mail-Adresse. *recipient@example.com*Ersetzen Sie es durch die verifizierte E-Mail-Adresse, an die Sie die Nachricht senden möchten. **Anmerkung** Wenn sich Ihr Konto noch in der E-Mail-Sandbox-Umgebung von Amazon Pinpoint befindet, können Sie E-Mails nur an Adressen oder Domänen senden, die in Ihrem Amazon-Pinpoint-Konto verifiziert sind. Weitere Informationen zum Entfernen Ihres Kontos aus der Sandbox-Umgebung finden Sie unter [Anfordern von Produktionszugriff für E-Mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) im *Amazon-Pinpoint-Benutzerhandbuch*. 1. Wählen Sie **Send (Senden)** aus. Wenn die Nachricht erfolgreich gesendet wurde, zeigt der Antwortbereich den Status `200 OK` an. ``` { "ApplicationId": "12345678901234567890123456789012", "RequestId": "", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "", "MessageId": "" } } } ```