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 Amazon API Gateway, vous créez une API REST sous la forme d’un ensemble d’entités programmables, appelées ressources. Par exemple, vous utilisez une RestApiressource pour représenter une API qui peut contenir un ensemble d'entités Resource.
Chaque entité Resource
peut disposer d’une ou de plusieurs ressources Method. Une Method
est une demande entrante envoyée par le client et exprimée dans les paramètres et le corps de la demande. Elle définit l’interface de programmation de l’application afin que le client puisse accéder à la Resource
exposée. Pour intégrer la Method
avec un point de terminaison de backend, également appelé point de terminaison d’intégration, vous allez créer une ressource Integration. Cette opération transmet la demande entrante à un URI de point de terminaison d’intégration spécifié. Si nécessaire, vous devez transformer les paramètres ou le corps de la demande pour répondre aux exigences du backend.
Pour les réponses, vous pouvez créer une ressource MethodResponse afin de représenter une réponse à la demande reçue par le client et créer une ressource IntegrationResponse pour représenter la réponse à la demande renvoyée par le backend. Vous pouvez configurer la réponse d'intégration pour transformer les données de la réponse du backend avant de les renvoyer au client ou pour transmettre la réponse du backend telle quelle au client.
Pour aider vos clients à comprendre votre API, vous pouvez également fournir une documentation sur l'API, dans le cadre de la création de l'API ou une fois l'API créée. Pour ce faire, ajoutez une ressource DocumentationPart pour une entité d'API prise en charge.
Pour contrôler la manière dont les clients appellent une API, utilisez des autorisations IAM, un mécanisme d'autorisation Lambda ou un groupe d'utilisateurs Amazon Cognito. Pour mesurer l’utilisation de votre API, configurez des plans d’utilisation pour limiter les demandes d’API. Vous pouvez les activer lors de la création ou de la mise à jour de l’API.
Pour une introduction à la création d’une API, consultez Didacticiel : création d’une API REST avec une intégration de proxy Lambda. Pour en savoir plus sur les fonctionnalités d’API Gateway que vous pouvez utiliser lors du développement d’une API REST, consultez les rubriques suivantes. Ces rubriques contiennent des informations conceptuelles et des procédures que vous pouvez exécuter à l'aide de la console API Gateway, de l'API REST API Gateway AWS CLI, de ou de l'une des AWS SDKs.