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.
Dans cette section, vous allez créer une nouvelle API en utilisant Amazon API Gateway dans le cadre de l'enregistrement par SMS pour Amazon Pinpoint. Le formulaire d'enregistrement que vous déployez dans cette solution appelle cette API. API Gateway transmet ensuite les informations capturées sur le formulaire d'enregistrement à la fonction Lambda que vous avez créée dans Create Lambda functions.
Tout d'abord, vous devez créer une nouvelle API dans API Gateway. Les procédures suivantes vous montrent comment créer une nouvelle API REST.
Pour créer une nouvelle API
Ouvrez la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway/
. -
Sélectionnez Create API (Créer une API). Effectuez les sélections suivantes :
-
Sous Choose the protocol (Choisir le protocole), choisissez REST.
-
Sous Create new API (Créer une nouvelle API), choisissez New API (Nouvelle API).
-
Sous Settings (Paramètres), pour Name (Nom), entrez un nom, par exemple
RegistrationForm
. Pour Description, vous pouvez saisir un texte qui décrit l'objectif de l'API. Pour Endpoint Type (Type de point de terminaison), choisissez Regional (Régional). Ensuite, choisissez Create API (Créer une API).
Un exemple de ces paramètres est illustré dans l'image suivante.
-
Maintenant que vous avez créé une API, vous pouvez commencer à y ajouter des ressources. Une fois que vous ajoutez une méthode POST à la ressource et demandez à API Gateway de transmettre les données que vous recevez de cette méthode à votre fonction Lambda.
-
Dans le menu Actions, choisissez Create Resource (Créer une ressource). Dans le volet New Child Resource (Nouvelle ressource enfant), pour Resource Name (Nom de la ressource), entrez
register
, comme illustré dans l'image suivante. Choisissez Create Resource. -
Dans le menu Actions, sélectionnez Create method (Créer une méthode). Dans le menu qui s'affiche, choisissez POST, comme illustré dans l'image suivante. Cliquez ensuite sur le bouton en forme de coche.
-
Dans le volet /register - POST - Setup, effectuez les sélections suivantes :
-
Pour Integration type (Type d'intégration), choisissez Lambda Function (Fonction Lambda).
-
Sélectionnez Utiliser l'intégration de proxy Lambda.
-
Pour Région Lambda, choisissez la région dans laquelle vous avez créé la fonction Lambda.
-
Pour Lambda Function, choisissez la RegisterEndpoint fonction que vous avez créée dans Create Lambda functions.
Un exemple de ces paramètres est illustré dans l'image suivante.
Choisissez Save (Enregistrer). Dans la fenêtre qui s'affiche, choisissez OK pour donner à API Gateway l'autorisation d'exécuter votre fonction Lambda.
-
L'API est maintenant prête à être utilisée. À ce stade, vous devez la déployer pour créer un point de terminaison accessible publiquement.
-
Dans le menu Actions, choisissez Deploy API (Déployer l'API). Dans la fenêtre Deploy API (Déployer l'API), effectuez les sélections suivantes :
-
Dans Deployment stage (Étape de déploiement), sélectionnez [New Stage] [Nouvelle étape].
-
Sous Stage name (Nom de l'étape), entrez
v1
. -
Choisissez Deploy (Déployer).
Un exemple de ces sélections est illustré dans l'image suivante.
-
-
Dans le volet v1 Stage Editor, choisissez la ressource /register, puis choisissez la méthode POST. Copiez l'adresse qui est affichée à côté d'Invoke URL (URL d'appel)), comme illustré dans l'image suivante.
-
Dans le panneau de navigation, choisissez Resources (Ressources). Dans la liste des ressources, choisissez la ressource /registrer. Enfin, dans le menu Actions, choisissez Enable CORS (Activer CORS), comme illustré dans l'image suivante.
-
Dans le volet Enable CORS (Activer CORS), choisissez Enable CORS and replace existing CORS headers (Activer CORS et remplacer les en-têtes CORS existants).
Suivant : Créer et déployer le formulaire web