**Avis de fin de support :** le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analytique). Pour plus d’informations, consultez [Fin de la prise en charge d’Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Remarque :** en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final. 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. # Tutoriel : utilisation de Postman avec l'API Amazon Pinpoint Postman est un outil populaire pour les tests APIs dans un environnement easy-to-use graphique. Vous pouvez utiliser Postman pour envoyer des demandes d'API à n'importe quelle API REST et recevoir des réponses à vos demandes. Utiliser Postman est un moyen pratique pour tester et dépanner les appels à l'API Amazon Pinpoint que vous effectuez. Ce tutoriel inclut les procédures de configuration et d'utilisation de Postman avec Amazon Pinpoint. **Note** Postman est développé par une entreprise tierce. Il n'est ni développé ni pris en charge par Amazon Web Services (AWS). Pour en savoir plus sur l’utilisation de Postman ou pour obtenir de l’aide sur des problèmes liés à Postman, consultez le [Centre de support](https://support.postman.com/hc/en-us) sur le site web de Postman. ## À propos de ce didacticiel Cette section contient une vue d'ensemble de ce didacticiel. **Public visé** Ce didacticiel est destiné aux développeurs et aux personnes chargées de l'implémentation du système. Vous n'avez pas besoin d'être familiarisé avec Amazon Pinpoint ou Postman pour effectuer les étapes de ce tutoriel. Vous devez être à l'aise avec la gestion des politiques IAM et la modification des exemples de code JSON. Les procédures décrites dans ce tutoriel ont été conçues pour empêcher les nouveaux utilisateurs d'utiliser les opérations d'API qui peuvent supprimer définitivement les ressources Amazon Pinpoint. Les utilisateurs avancés peuvent supprimer cette restriction en modifiant la stratégie associée à leurs utilisateurs . **Fonctionnalités utilisées** Ce tutoriel inclut des exemples d'utilisation pour les fonctionnalités Amazon Pinpoint suivantes : + Interaction avec l'API Amazon Pinpoint à l'aide de Postman **Temps requis** Ce didacticiel dure environ 15 minutes. **Restrictions régionales** Il n'y a pas de restrictions régionales associées à l'utilisation de cette solution. **Coûts d'utilisation des ressources** La création d'un AWS compte est gratuite. Cependant, la mise en œuvre de cette solution peut entraîner des coûts AWS d'utilisation si vous utilisez Postman pour effectuer l'une des opérations suivantes : + Envoyer des e-mails, des SMS, des push mobile ou des messages vocaux + Créer et envoyer des campagnes + Utiliser la fonction de validation de numéro de téléphone Pour plus d'informations sur les frais associés à l'utilisation d'Amazon Pinpoint, consultez [Tarification d'Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/). # Conditions préalables à l'utilisation de Postman avec Amazon Pinpoint Avant de commencer le didacticiel, suivez les conditions préalables requises : + Vous devez avoir un AWS compte. Pour créer un AWS compte, allez sur [https://console.aws.amazon.com/](https://console.aws.amazon.com/)et choisissez **Créer un nouveau AWS compte**. + Assurez-vous que le compte que vous utilisez pour vous connecter AWS Management Console peut créer de nouvelles politiques et de nouveaux rôles IAM. + Assurez-vous d'avoir créé au moins un exemple de projet dans lequel les e-mails sont activés et dont l'identité e-mail est vérifiée. Consultez [Création d'un projet Amazon Pinpoint avec assistance par e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) dans le *Guide de l'utilisateur Amazon Pinpoint*. + Assurez-vous d'avoir un identifiant de AWS compte. Votre identifiant de AWS compte se trouve dans le coin supérieur droit de la console ou vous pouvez utiliser l'interface de ligne de commande (CLI). Consultez la section [Trouver l'identifiant de votre AWS compte](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). + Vous devez télécharger et installer Postman sur votre ordinateur. Vous pouvez télécharger Postman à partir du [site web de Postman](https://www.getpostman.com). + Une fois que vous avez installé Postman sur votre ordinateur, créez un compte Postman. Lorsque vous démarrez l'application Postman pour la première fois, vous êtes invité à vous connecter ou à créer un nouveau compte. Suivez les instructions fournies par Postman pour vous connecter à votre compte ou pour créer un compte si vous n'en avez pas déjà un. **Suivant** : [Création de politiques et de rôles IAM](tutorials-using-postman-iam-user.md) # Créez des politiques et des rôles IAM à utiliser avec Amazon Pinpoint Lorsque vous utilisez Postman pour tester l'API Amazon Pinpoint, la première étape consiste à créer un utilisateur. Dans cette section, vous créez une politique qui permet aux utilisateurs d'interagir avec toutes les ressources Amazon Pinpoint. Ensuite, vous créez un utilisateur et attachez la politique directement à l'utilisateur. ## Créer une politique IAM Découvrez comment créer une politique IAM. Les utilisateurs et les rôles qui utilisent cette politiques peuvent interagir avec toutes les ressources de l'API Amazon Pinpoint. Elle permet également d'accéder aux ressources associées à l'API Amazon Pinpoint Email, ainsi qu'à l'API Amazon Pinpoint SMS et voix. **Pour créer la politique** 1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Dans le volet de navigation, sélectionnez **Politiques**, puis **Créer une politique**. 1. Dans l'**éditeur de politiques**, sélectionnez **JSON**. Supprimez tout JSON actuel dans l'**éditeur de politiques** afin qu'il soit vide. Copiez et collez le code JSON suivant dans l'**éditeur de stratégie**, puis remplacez toutes les instances de par votre Compte AWS identifiant dans *123456789012* l'**éditeur de stratégie**. Votre Compte AWS identifiant se trouve dans le coin supérieur droit de la console, ou vous pouvez utiliser la CLI, voir [Trouver l'identifiant de votre AWS compte](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). **Note** Pour protéger les données de votre compte Amazon Pinpoint, cette politique inclut uniquement les autorisations qui vous permettent de consulter, créer et modifier des ressources. Elle n'inclut pas les autorisations qui vous permettent de supprimer les ressources. Vous pouvez modifier cette politique à l'aide de l'éditeur visuel dans la console IAM. Pour plus d'informations, consultez [Gestion des politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) dans le Guide de l'utilisateur IAM. Vous pouvez également utiliser l'[CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)opération dans l'API IAM pour mettre à jour cette politique. Notez également que cette politique inclut les autorisations qui vous permettent d'interagir avec les services `ses` et `sms-voice`, en plus du service `mobiletargeting`. Les autorisations `ses` et `sms-voice` vous permettent d'interagir avec l'API Amazon Pinpoint Email et l'API Amazon Pinpoint SMS et voix, respectivement. Les autorisations `mobiletargeting` vous permettent d'interagir avec l'API Amazon Pinpoint. ------ #### [ 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": "*" } ] } ``` ------ Choisissez **Suivant**. 1. Dans **Nom de la stratégie**, entrez un nom pour la stratégie, tel que**PostmanAccessPolicy**. Choisissez **Create Policy** (Créer une politique). 1. (Facultatif) Vous pouvez ajouter des balises à la politique en sélectionnant **Ajouter une balise**. 1. Choisissez **Suivant : Vérification**. ## Créer un utilisateur IAM **Avertissement** Les utilisateurs IAM disposent d’informations d’identification à long terme, ce qui présente un risque de sécurité. Pour atténuer ce risque, nous vous recommandons de ne fournir à ces utilisateurs que les autorisations dont ils ont besoin pour effectuer la tâche et de supprimer ces autorisations lorsqu’elles ne sont plus nécessaires. Une fois que vous avez créé la politique, vous pouvez créer un utilisateur et lui attacher la politique. Lorsque vous créez l'utilisateur, IAM fournit un ensemble d'informations d'identification pour autoriser Postman à exécuter des opérations d'API Amazon Pinpoint. **Pour créer l'utilisateur** 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Sur la console IAM, dans le volet de navigation, choisissez **Users**, puis **Create users**. 1. Sous **Informations utilisateur**, pour **Nom utilisateur**, saisissez un nom qui identifie l'utilisateur, par exemple **PostmanUser**. Ensuite, sélectionnez **Suivant**. 1. Sous **Définir les autorisations**, pour les **Options d'autorisations**, choisissez **Attacher directement les politiques**. 1. Sous **Politiques d'autorisations**, choisissez la stratégie (**PostmanAccessPolicy**) que vous avez créée dans [Créer une stratégie IAM](#tutorials-using-postman-iam-user-create-policy). Ensuite, sélectionnez **Suivant**. 1. Sur la page **Examiner et créer**, ajoutez, si vous le souhaitez, des balises qui vous aident à identifier l'utilisateur. Pour plus d'informations sur l'utilisation des balises, consultez la rubrique [Balisage des ressources IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) dans le *Guide de l'utilisateur IAM*. 1. Lorsque vous êtes prêt à créer l'utilisateur, choisissez **Create user (Créer un utilisateur)**. ## Création de clés d'accès **Avertissement** Dans ce scénario, l’utilisateur IAM doit disposer d’un accès programmatique et d’informations d’identification à long terme, ce qui peut présenter un risque de sécurité. Pour atténuer ce risque, nous vous recommandons de ne fournir à ces utilisateurs que les autorisations dont ils ont besoin pour effectuer la tâche et de supprimer ces autorisations lorsqu’elles ne sont plus nécessaires. Les clés d’accès peuvent être mises à jour si nécessaire. Pour plus d’informations, consultez [Mettre à jour les clés d’accès](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html) dans le *Guide de l’utilisateur IAM*. IAM fournit un ensemble d'informations d'identification que vous pouvez utiliser pour autoriser Postman à exécuter des opérations d'API Amazon Pinpoint. **Pour créer l'utilisateur** 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Dans le panneau de navigation de la console IAM, sélectionnez **Utilisateurs**. Sélectionnez l'utilisateur (**PostmanUser**) créé dans [Créer un utilisateur IAM](#tutorials-using-postman-iam-user-create-user), puis sélectionnez l'onglet **Informations d'identification de sécurité**. 1. Dans la section **Clés d’accès**, choisissez **Créer une clé d’accès**. 1. Sur la page **Meilleures pratiques et alternatives relatives aux clés d'accès**, sélectionnez **Application exécutée en dehors AWS**. Ensuite, sélectionnez **Suivant**. 1. (Facultatif) Vous pouvez ajouter une balise de description à la politique. 1. Choisissez **Create access key (Créer une clé d’accès)**. 1. Sur la page **Récupérer les clés d'accès**, copiez les informations d'identification qui sont affichées dans les colonnes **Clé d'accès** et **Clé d'accès secrète**. **Note** Vous devez fournir l'ID de clé d'accès et la clé d'accès secrète ultérieurement dans ce tutoriel. C'est la seule fois que vous pourrez afficher la clé d'accès secrète. Nous vous recommandons de la copier et de l'enregistrer dans un emplacement sûr. 1. Après avoir enregistré les deux clés, choisissez **Terminé**. **Suivant** : [Configuration de Postman](tutorials-using-postman-configuration.md) # Configurer Postman pour une utilisation avec Amazon Pinpoint Maintenant que vous avez créé un utilisateur en mesure d'accéder à l'API Amazon Pinpoint, vous pouvez configurer Postman. Dans cette section, vous allez créer un ou plusieurs environnements dans Postman. Ensuite, vous importez une collection qui contient un modèle de demande pour chacune des opérations de l'API Amazon Pinpoint. ## Création d'un espace de travail Postman 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**. 1. Entrez un nom, un résumé et définissez la visibilité sur Personnel. Choisissez ensuite **Créer un espace de travail**. ## Créez des environnements Postman 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 demandes d'API 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**. 1. Dans la fenêtre **Create New (Créer)**, choisissez **Environment (Environnement)**. 1. Dans la fenêtre **MANAGE ENVIRONMENTS (GÉRER LES ENVIRONNEMENTS)**, pour **Environment Name (Nom de l'environnement)**, saisissez **Amazon Pinpoint - *Region Name***. Remplacez *Region Name* par 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, vous ne devez créer qu'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](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) dans le guide de l'utilisateur *Amazon Pinpoint*. 1. 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/tutorials-using-postman-configuration.html) Une fois que vous avez créé ces variables, la fenêtre **MANAGE ENVIRONMENTS (GÉRER LES ENVIRONNEMENT)** ressemble à l'exemple présenté dans l'image suivante. ![\[\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png) 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 d'accès IAM 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 [Bonnes pratiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) dans le *Guide de l’utilisateur IAM*. 1. (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éer un environnement distinct pour chaque région dans laquelle vous devez tester l'API Amazon Pinpoint. 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. 1. Lorsque vous avez fini de créer des environnements, passez à la section suivante. ## Créez une collection Amazon Pinpoint dans Postman Dans Postman, une *collection* est un groupe de demandes d'API. Les demandes d'une collection ont généralement un objectif commun qui les unit. Dans cette section, vous créez une nouvelle collection qui contient un modèle de demande pour chaque opération dans l'API Amazon Pinpoint. **Pour créer la collection Amazon Pinpoint** 1. Dans Postman, choisissez le menu plus d'actions, choisissez **Fichier**, puis **Importer**. 1. Dans la fenêtre **d'importation**, choisissez **Importer depuis un lien**, puis entrez l'URL suivante : [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. Choisissez **Importer**. Postman importe la collection Amazon Pinpoint, qui contient 120 exemples de demande. ## Test de la configuration de Postman 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**. 1. Dans la liste des demandes, sélectionnez **GetApps**. 1. Utilisez le sélecteur d'**environnement** pour choisir l'environnement que vous avez créé dans les environnements [Create Postman](#tutorials-using-postman-configuration-create-environments). 1. 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. ![\[\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png) **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 Une erreur s'est produite lors de la connexion à 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 valeurs `accessKey` et `secretAccessKey` s'affichent dans les colonnes **VALEUR INITIALE** et **VALEUR ACTUELLE** et que vous avez saisi les informations d'identification correctement. | | « Message » : « L'utilisateur : arn:aws:iam : :123456789012:user/ n'PinpointPostmanUserest pas autorisé à effectuer : mobiletargeting : on resource : arn:aws:mobiletargeting:us-west- 2:123456789012 :\$1 » GetApps | La politique IAM 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 politique IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy) et que vous avez fourni les informations d'identification correctes lorsque vous avez créé l'environnement dans l'espace de travail [Create Postman](#tutorials-using-postman-configuration-create-environments). | **Suivant** : [Envoi de demandes supplémentaires](tutorials-using-postman-sample-requests.md) # Envoyer des demandes à l'API Amazon Pinpoint Lorsque vous avez terminé la configuration et le test de Postman, vous pouvez commencer à envoyer des demandes supplémentaires à l'API Amazon Pinpoint. Cette section présente les informations que vous devez connaître avant de commencer à envoyer des demandes. Elle inclut également deux exemples de demandes qui décrivent comment utiliser la collection Amazon Pinpoint. **Important** Lorsque vous effectuez les procédures de cette section, vous soumettez des demandes à l'API Amazon Pinpoint. Ces demandes permettent de créer de nouvelles ressources dans votre compte Amazon Pinpoint, de modifier des ressources existantes, d'envoyer des messages, de modifier la configuration de vos projets Amazon Pinpoint et d'utiliser d'autres fonctionnalités d'Amazon Pinpoint. Soyez prudent lorsque vous exécutez ces demandes. ## Exemples de la collection Amazon Pinpoint Postman Vous devez configurer la plupart des opérations dans la collection Postman d'Amazon Pinpoint avant de pouvoir les utiliser. Pour les opérations `GET` et `DELETE`, vous devez généralement modifier uniquement les variables qui sont définies dans l'onglet **Pre-request Script (Script de pré-demande)**. **Note** Lorsque vous utilisez la politique IAM présentée dans [Créer une stratégie IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy), vous ne pouvez exécuter aucune des `DELETE` demandes incluses dans cette collection. Par exemple, l'opération `GetCampaign` nécessite que vous spécifiez un `projectId` et un `campaignId`. Dans l'onglet **Pre-request Script (Script de pré-demande)**, ces deux variables sont présentes et sont renseignées avec des exemples de valeurs. Supprimez les exemples de valeurs et remplacez-les par les valeurs applicables pour votre projet et votre campagne Amazon Pinpoint. Parmi ces variables, la plus couramment utilisée est la variable `projectId`. Sa valeur doit être l'identifiant unique du projet concerné par votre demande. Pour obtenir la liste de ces identifiants pour vos projets, vous pouvez vous référer à la réponse à la demande `GetApps` que vous avez envoyée à l'étape précédente de ce tutoriel. Dans cette réponse, le champ `Id` fournit l'identifiant unique d'un projet. Pour en savoir plus sur l'opération `GetApps` et la signification de chaque champ de la réponse, consultez [Applications](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) dans la *Référence de l'API Amazon Pinpoint*. **Note** Dans Amazon Pinpoint, un « projet » est identique à une « application » ou à une « application ». Pour les opérations `POST` et `PUT`, vous devez également modifier le corps de la demande afin d'inclure les valeurs que vous souhaitez envoyer à l'API. Par exemple, lorsque vous soumettez une demande `CreateApp`, qui est une demande `POST`, vous devez spécifier un nom pour le projet que vous créez. Vous pouvez modifier la demande sur l'onglet **Body (Corps)**. Dans cet exemple, remplacez la valeur située à côté de `"Name"` par le nom du projet. Si vous souhaitez ajouter des balises au projet, vous pouvez les spécifier dans l'objet `tags`. Si vous ne souhaitez pas ajouter de balises, vous pouvez supprimer l'intégralité de l'objet `tags`. **Note** L'opération `UntagResource` nécessite également que vous spécifiez les paramètres d'URL. Vous pouvez spécifier ces paramètres dans l'onglet **Params (Paramètres)**. Remplacez les valeurs de la colonne **VALUE (VALEUR)** par les balises que vous souhaitez supprimer pour la ressource spécifiée. ## Exemple de demande : créer un projet à l'aide de l'`CreateApp`opération Avant de créer des segments et des campagnes dans Amazon Pinpoint, vous devez d'abord créer un projet. Dans Amazon Pinpoint, un *projet* se compose de segments, campagnes, configurations et données unis par un objectif commun. Par exemple, vous pouvez utiliser un projet pour contenir l’ensemble du contenu qui est lié à une application particulière ou à une initiative marketing ou marque spécifique. Lorsque vous ajoutez les informations client à Amazon Pinpoint, ces informations sont associées à un projet. **Pour créer un projet en envoyant une demande d' CreateApp API** 1. Dans le menu **Environnements**, choisissez Région AWS celui dans lequel vous souhaitez créer le projet. ![\[\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) Dans cet exemple, Postman a été configuré de telle sorte que le menu **Environments (Environnements)** affiche les quatre options suivantes : + USA Est (Virginie du Nord) + USA Ouest (Oregon) + Europe (Francfort) + Europe (Irlande) 1. Dans le dossier **Apps**, choisissez l'**CreateApp**opération>. ![\[\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) Le dossier **Apps** de la collection Amazon Pinpoint Postman est agrandi et affiche les demandes suivantes : + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. Dans l'onglet **Body (Corps)**, en regard de `"Name"`, remplacez la valeur d'espace réservé (`"string"`) par un nom pour la campagne, tel que **"MySampleProject"**. 1. Supprimez la virgule après le nom de la campagne, puis supprimez l'intégralité de l'objet `tags` sur les lignes 3 à 5. Lorsque vous avez terminé, votre demande devrait ressembler à l'exemple qui est illustré dans l'extrait de code suivant. ``` { "Name": "MySampleProject" } ``` Postman est configuré pour envoyer la demande en tant que charge utile JSON brute. 1. Sélectionnez **Send (Envoyer)**. Si la campagne est créée avec succès, le volet de réponse indique le statut `201 Created`. ``` { "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} } ``` ## Exemple : envoyer un e-mail en utilisant l'`SendMessages`opération Il est très courant d'utiliser l'API Amazon Pinpoint `SendMessages` pour envoyer des messages transactionnels. Un avantage de l'envoi de messages à l'aide de l'API `SendMessages`, par opposition à la création de campagnes, est que vous pouvez envoyer des messages à n'importe quelle adresse (par exemple, une adresse e-mail, un numéro de téléphone ou un jeton d'appareil). L'adresse à laquelle vous envoyez des messages ne doit pas déjà exister dans votre compte Amazon Pinpoint. Comparons cette méthode à l'envoi de messages en créant des campagnes. Avant d'envoyer une campagne dans Amazon Pinpoint, vous devez ajouter des points de terminaison à votre compte Amazon Pinpoint, créer des segments, créer la campagne et la mener à bien. L'exemple de cette section vous montre comment envoyer un e-mail transactionnel directement à une adresse e-mail spécifique. Vous pouvez modifier cette demande pour envoyer des messages via d'autres canaux, comme les SMS, push mobile ou la messagerie vocale. **Pour envoyer un message électronique en soumettant une SendMessages demande** 1. Vérifiez que le canal de messagerie est activé pour le projet et que l'adresse e-mail ou le domaine que vous souhaitez utiliser pour envoyer et recevoir le message est configuré. Pour plus d'informations, consultez les sections [Activation et désactivation du canal e-mail](pinpoint/latest/userguide/channels-email-setup.html) et [Vérification des identités e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) dans le *Guide de l'utilisateur Amazon Pinpoint*. **Note** Pour compléter la procédure de cette section, vous devez vérifier votre adresse e-mail 1. Dans le menu **Environnements**, choisissez Région AWS celui à partir duquel vous souhaitez envoyer le message. Dans cet exemple, Postman a été configuré de telle sorte que le menu **Environments (Environnements)** affiche les quatre options suivantes : + USA Est (Virginie du Nord) + USA Ouest (Oregon) + Europe (Francfort) + Europe (Irlande) 1. Dans le dossier **Messages**, choisissez l'**SendMessages**opération. ![\[\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. Dans l'onglet **Pre-request Script (Script de pré-demande)**, remplacez la valeur de la variable `projectId` par l'ID d'un projet qui existe déjà dans la région que vous avez sélectionnée à l'étape 2 de cette section. 1. Dans l'onglet **Body (Corps)**, supprimez l'exemple de demande qui est affiché dans l'éditeur de demande. Collez le code suivant : ``` { "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. Dans le code précédent, remplacez *sender@example.com* par votre adresse e-mail vérifiée. Remplacez *recipient@example.com* par l'adresse e-mail vérifiée à laquelle vous souhaitez envoyer le message. **Note** Si votre compte se trouve encore dans l'environnement de test (sandbox) Amazon Pinpoint, vous ne pouvez envoyer des e-mails qu'aux adresses ou domaines vérifiés dans votre compte Amazon Pinpoint. Pour plus d'informations sur la suppression de votre compte de l'environnement de test (sandbox), veuillez consulter [Demande d'un accès en production pour les e-mails](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) dans le *Guide de l'utilisateur d'Amazon Pinpoint*. 1. Sélectionnez **Send (Envoyer)**. Si le message est envoyé avec succès, le volet de réponse indique le statut `200 OK`. ``` { "ApplicationId": "12345678901234567890123456789012", "RequestId": "", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "", "MessageId": "" } } } ```