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.

# Développement du protocole HTTP APIs dans API Gateway
<a name="http-api-develop"></a>

Cette section fournit des détails sur les fonctionnalités d'API Gateway dont vous avez besoin pour développer votre API Gateway APIs.

Au fur et à mesure que vous développez votre API API Gateway, vous décidez d’un certain nombre de caractéristiques de votre API. Ces caractéristiques dépendent du cas d’utilisation de votre API. Par exemple, vous pourriez vouloir autoriser uniquement certains clients à appeler votre API ou qu’elle soit disponible pour tout le monde. Vous pouvez souhaiter utiliser un appel d’API pour exécuter une fonction Lambda, créer une requête de base de données ou appeler une application.

**Topics**
+ [Création d’une API HTTP](#http-api-examples)
+ [Création de routes pour HTTP APIs dans API Gateway](http-api-develop-routes.md)
+ [Types d’adresses IP pour les API HTTP dans API Gateway](http-api-ip-address-type.md)
+ [Contrôler et gérer l'accès au protocole HTTP APIs dans API Gateway](http-api-access-control.md)
+ [Création d’intégrations pour les API HTTP dans API Gateway](http-api-develop-integrations.md)
+ [Configurer CORS pour HTTP APIs dans API Gateway](http-api-cors.md)
+ [Transformation des demandes et des réponses d’API HTTP dans API Gateway](http-api-parameter-mapping.md)
+ [Utiliser les définitions OpenAPI pour HTTP APIs dans API Gateway](http-api-open-api.md)

## Création d’une API HTTP
<a name="http-api-examples"></a>

Pour créer une API fonctionnelle, vous devez disposer d’au moins une route, une intégration, une étape et un déploiement.

Les exemples suivants montrent comment créer une API avec une intégration AWS Lambda ou HTTP, une route et une étape par défaut configurée pour déployer automatiquement les modifications.

Ce guide suppose que vous connaissez déjà API Gateway et Lambda. Pour obtenir un guide plus détaillé, consultez [Mise en route avec API Gateway](getting-started.md).

**Topics**
+ [Créez une API HTTP à l'aide du AWS Management Console](#apigateway-http-api-create.console)
+ [Création d'une API HTTP à l'aide de la AWS CLI](#http-api-examples.cli.quick-create)

### Créez une API HTTP à l'aide du AWS Management Console
<a name="apigateway-http-api-create.console"></a>

1. Ouvrez la [console API Gateway](https://console.aws.amazon.com/apigateway).

1. Sélectionnez **Create API (Créer une API)**.

1. Sous **API HTTP**, choisissez **Créer**.

1. Choisissez **Ajouter une intégration**, puis choisissez une fonction AWS Lambda ou entrez un point de terminaison HTTP.

1. Dans **Name (Nom)**, entrez le nom de votre API.

1. Choisissez **Review and create**.

1. Choisissez **Créer**.

Maintenant, votre API est prête à être appelée. Vous pouvez tester votre API en entrant son URL d'appel dans un navigateur, ou en utilisant Curl.

```
curl https://{{api-id}}.execute-api.{{us-east-2}}.amazonaws.com
```

### Création d'une API HTTP à l'aide de la AWS CLI
<a name="http-api-examples.cli.quick-create"></a>

Vous pouvez utiliser la création rapide pour créer une API avec une intégration Lambda ou HTTP, une route fourre-tout par défaut et une étape par défaut configurée pour déployer automatiquement les modifications. La commande [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) suivante utilise la création rapide pour créer une API qui s’intègre avec une fonction Lambda sur le backend.

**Note**  
Pour appeler une intégration Lambda, API Gateway doit disposer des autorisations requises. Vous pouvez utiliser une politique basée sur les ressources ou un rôle IAM pour accorder des autorisations API Gateway permettant d’appeler une fonction Lambda. Pour en savoir plus, consultez la section [AWS Lambda Permissions](https://docs.aws.amazon.com/lambda/latest/dg/lambda-permissions.html) dans le *guide du AWS Lambda développeur*.

**Example**  

```
aws apigatewayv2 create-api --name {{my-api}} --protocol-type HTTP --target arn:aws:lambda:{{us-east-2}}:{{123456789012}}:function:{{function-name}}
```

Maintenant, votre API est prête à être appelée. Vous pouvez tester votre API en entrant son URL d'appel dans un navigateur, ou en utilisant Curl.

```
curl https://{{api-id}}.execute-api.{{us-east-2}}.amazonaws.com
```