Configurer Postman pour une utilisation avec Amazon Pinpoint - Amazon Pinpoint

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurer Postman pour une utilisation avec Amazon Pinpoint

Maintenant que vous avez créé un utilisateur capable d'accéder à Amazon PinpointAPI, vous pouvez configurer Postman. Dans cette section, vous allez créer un ou plusieurs environnements dans Postman. Ensuite, vous importez une collection contenant un modèle de demande pour chacune des opérations dans Amazon PinpointAPI.

Dans Postman, un espace de travail est un conteneur organisationnel pour les projets et les environnements. Dans cette section, vous créez au moins un espace de travail à utiliser avec Amazon Pinpoint.

Création d’un espace de travail

Dans Postman, choisissez le plus d'actions, choisissez Fichier, puis Nouveau.

  1. Dans la fenêtre Créer nouveau, choisissez Espace de travail.

  2. Entrez un nom, un résumé et définissez la visibilité sur Personnel. Choisissez ensuite Créer un espace de travail.

Dans Postman, un environnement est un ensemble de variables qui sont stockées en tant que paires clé-valeur. Vous pouvez utiliser des environnements pour modifier la configuration des demandes que vous effectuez via Postman, sans avoir à modifier les API demandes elles-mêmes.

Dans cette section, vous allez créer au moins un environnement à utiliser avec Amazon Pinpoint. Chaque environnement que vous créez contient un ensemble de variables qui sont spécifiques à votre compte dans une seule Région AWS. Si vous utilisez les procédures de cette section pour créer plusieurs environnements, vous pouvez passer d'une région à l'autre en choisissant un autre environnement dans le menu Environnement de Postman.

Pour créer un environnement .

  1. Dans Postman, choisissez le menu plus d'actions, choisissez Fichier, puis Nouveau.

  2. Dans la fenêtre Create New (Créer), choisissez Environment (Environnement).

  3. MANAGEENVIRONMENTSDans la fenêtre, pour Nom de l'environnement, entrezAmazon Pinpoint - Region Name. Remplacez Region Name avec l'une des valeurs suivantes :

    • USA Est (Virginie du Nord)

    • USA Ouest (Oregon)

    • Asie-Pacifique (Mumbai)

    • Asie-Pacifique (Sydney)

    • Europe (Francfort)

    • Europe (Irlande)

    Note

    Au minimum, il vous suffit de créer un seul environnement pour un seul Région AWS, qui Région AWS doit contenir un seul projet. Si vous n'avez pas créé de projet dans l'une des listes précédentes Régions AWS, consultez la section Création d'un projet Amazon Pinpoint avec assistance par e-mail dans le guide de l'utilisateur Amazon Pinpoint.

  4. Créez six nouvelles variables: endpoint, region, serviceName, accountId, accessKey et secretAccessKey. Utilisez le tableau suivant pour déterminer quelle valeur saisir dans les colonnes Valeur initiale et Valeur actuelle pour chaque variable.

    Région Variable Valeur initiale et actuelle
    USA Est (Virginie du Nord) endpoint pinpoint.us-east-1.amazonaws.com
    region us-east-1
    serviceName mobiletargeting
    accountId (votre identifiant de AWS compte)
    accessKey (ID de votre clé d'accès IAM)
    secretAccessKey (votre clé d'accès secrète IAM)
    USA Ouest (Oregon) endpoint pinpoint.us-west-2.amazonaws.com
    region us-west-2
    serviceName mobiletargeting
    accountId (votre identifiant de AWS compte)
    accessKey (ID de votre clé d'accès IAM)
    secretAccessKey (votre clé d'accès secrète IAM)
    Asie-Pacifique (Mumbai) endpoint pinpoint.ap-south-1.amazonaws.com
    region ap-south-1
    serviceName mobiletargeting
    accountId (votre identifiant de AWS compte)
    accessKey (ID de votre clé d'accès IAM)
    secretAccessKey (votre clé d'accès secrète IAM)
    Asie-Pacifique (Sydney) endpoint pinpoint.ap-southeast-2.amazonaws.com
    region ap-southeast-2
    serviceName mobiletargeting
    accountId (votre identifiant de AWS compte)
    accessKey (ID de votre clé d'accès IAM)
    secretAccessKey (votre clé d'accès secrète IAM)
    Europe (Francfort) endpoint pinpoint.eu-central-1.amazonaws.com
    region eu-central-1
    serviceName mobiletargeting
    accountId (votre identifiant de AWS compte)
    accessKey (ID de votre clé d'accès IAM)
    secretAccessKey (votre clé d'accès secrète IAM)
    Europe (Irlande) endpoint pinpoint.eu-west-1.amazonaws.com
    region eu-west-1
    serviceName mobiletargeting
    accountId (votre identifiant de AWS compte)
    accessKey (ID de votre clé d'accès IAM)
    secretAccessKey (votre clé d'accès secrète IAM)

    Après avoir créé ces variables, la MANAGEENVIRONMENTSfenêtre ressemble à l'exemple illustré dans l'image suivante.

    Fenêtre Gérer les environnements dans Postman. La capture d'écran illustre un environnement nommé « USA Est (Virginie du Nord) ». L'environnement contient les variables suivantes : Une variable nommée « point de terminaison » et une valeur initiale de »pinpoint.us-east-1.amazonaws.com". Une variable nommée « region » et une valeur initiale de « us-east-1 ». Une variable nommée « serviceName » et une valeur initiale de « mobiletargeting ». Une variable nommée « accountId » et une valeur initiale de 123456789012 (un identifiant de compte fictif). AWS Une variable nommée « accessKey » et une valeur initiale de AKIAIOSFODNN7EXAMPLE (un identifiant de clé d'accès fictif). Une variable nommée « secretAccessKey » et une valeur initiale de wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY (clé d'accès secrète fictive).

    Lorsque vous avez terminé, choisissez Enregistrer.

    Important

    Les clés d'accès illustrées dans l'image précédente sont fictives. Ne partagez pas vos clés IAM d'accès avec d'autres personnes.

    Postman inclut des fonctionnalités qui vous permettent de partager et d'exporter des environnements. Si vous utilisez ces fonctionnalités, veillez à ne pas partager votre ID de clé d'accès et votre clé d'accès secrète avec une personne qui ne devrait pas avoir accès à ces informations d'identification.

    Pour plus d'informations, consultez les IAMmeilleures pratiques dans le guide de IAM l'utilisateur.

  5. (Facultatif) Répétez les étapes 1 à 4 pour chaque environnement supplémentaire que vous souhaitez créer.

    Astuce

    Dans Postman, vous pouvez créer autant d'environnements que vous le souhaitez. Vous pouvez utiliser les environnements des manières suivantes :

    • Créez un environnement distinct pour chaque région dans lequel vous devez tester Amazon PinpointAPI.

    • Créer des environnements qui sont associés à d'autres Comptes AWS.

    • Créer des environnements qui utilisent les informations d'identification associées à un autre utilisateur.

  6. Lorsque vous avez fini de créer des environnements, passez à la section suivante.

Dans Postman, une collection est un groupe de API demandes. Les demandes d'une collection ont généralement un objectif commun qui les unit. Dans cette section, vous allez créer une nouvelle collection qui contient un modèle de demande pour chaque opération dans Amazon API Pinpoint.

Pour créer la collection Amazon Pinpoint

  1. Dans Postman, choisissez le menu plus d'actions, choisissez Fichier, puis Importer.

  2. Dans la fenêtre d'importation, choisissez Importer depuis un lien, puis entrez ce qui suit URL : https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon %20Pinpoint.postman_collection.json.

    Choisissez Import (Importer). Postman importe la collection Amazon Pinpoint, qui contient 120 exemples de demande.

Une fois que vous avez importé la collection Amazon Pinpoint, nous recommandons d'effectuer un test rapide pour vérifier que tous les composants sont correctement configurés. Vous pouvez tester votre configuration en soumettant une demande GetApps. Cette demande renvoie une liste de tous les projets qui existent dans votre compte Amazon Pinpoint dans la région Région AWS actuelle. Cette demande ne nécessite aucune configuration supplémentaire. C'est donc un bon moyen de tester votre configuration.

Pour tester la configuration de la collection Amazon Pinpoint

  1. Dans le volet de navigation de gauche, sélectionnez Collections, développez la collection Amazon Pinpoint, puis développez le dossier Apps.

  2. Dans la liste des demandes, sélectionnez GetApps.

  3. Utilisez le sélecteur d'environnement pour choisir l'environnement que vous avez créé dans les environnements Create Postman.

  4. Sélectionnez Send (Envoyer). Si la demande est envoyée avec succès, le volet de réponse indique le statut 200 OK. Une réponse semblable à l'exemple présenté dans l'image ci-dessous s'affiche.

    La réponse présentant des exemples de valeurs pour Name, Id, Arn et Tags.
    Note

    Si aucun projet n'a été créé dans le Région AWS , Amazon Pinpoint revient. { "Item": [] }

    Cette réponse montre une liste de tous les projets Amazon Pinpoint qui existent dans votre compte dans la région que vous avez sélectionnée à l'étape 3.

Résolution des problèmes

Lorsque vous soumettez votre demande, vous pouvez voir un message d'erreur. La liste suivante contient plusieurs erreurs courantes que vous pouvez rencontrer et les étapes que vous pouvez effectuer pour les résoudre.

Message d’erreur Problème Résolution

Could not get any response

There was an error connecting to https://%7B%7Bendpoint%7D%7D/v1/apps.

Il n'y a pas de valeur actuelle pour la {{endpoint}} variable qui est définie lorsque vous choisissez un environnement.

Utilisez le sélecteur d'environnements pour choisir un environnement.

The security token included in the request is invalid.

Postman n'a pas été en mesure d'identifier la valeur actuelle de votre ID de clé d'accès ou de clé d'accès secrète.

Choisissez l'icône d'engrenage située près du sélecteur d'environnements, puis sélectionnez l'environnement actuel. Vérifiez que les secretAccessKey valeurs accessKey et apparaissent dans les deux CURRENTVALUEcolonnes INITIALVALUEet que vous avez correctement saisi les informations d'identification.

« Message » : « L'utilisateur : arn:aws:iam : :123456789012:user/ n'PinpointPostmanUserest pas autorisé à effectuer : mobiletargeting : on resource : arn:aws:mobiletargeting:us-west- 2:123456789012 :* » GetApps

La IAM politique associée à votre utilisateur n'inclut pas les autorisations appropriées.

Vérifiez que votre utilisateur dispose des autorisations décrites dans Créer une IAM politique et que vous avez fourni les informations d'identification correctes lorsque vous avez créé l'environnement dans l'espace de travail Create Postman.

Suivant : Envoi de demandes supplémentaires