Étape 4 : Tester votre API

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Pour tester l'API helloworld déployée, cliquez sur l'onglet Terminal dans Apigee dans Cloud Code, puis saisissez l'appel curl suivant :

curl 0:8998/helloworld

Remarque : Les exemples de cette section utilisent 0 pour la valeur d'hôte et 8998 pour la valeur du port. Vous pouvez configurer les valeurs de port, comme décrit dans Gérer l'émulateur Apigee. Si vous obtenez une erreur lors de l'utilisation de 0, remplacez localhost par 0 :

curl localhost:8998/helloworld

Le message d'erreur suivant s'affiche :

Appeler l'API dans l'onglet "Terminal" et obtenir une erreur d'autorisation

Puisque vous avez activé l'authentification basée sur une clé API lors de la création du proxy d'API, vous devez transmettre une clé API à l'aide du paramètre de requête apikey lors de l'appel d'API.

Pour obtenir une clé API, vous devez créer un groupe de test et configurer les ressources de test suivantes:

Produit API utilisé pour regrouper l'API et la mettre à la disposition des développeurs
Développeur qui créera une application pour accéder à l'API
Application de développement permettant d'accéder à l'API à l'aide d'une clé API

Créez et exportez des ressources de test, obtenez la clé API et testez de nouveau votre API.

Créez un groupe de test :
1. Placez le curseur sur le dossier tests dans la section Apigee, puis cliquez sur .
  
  L'assistant "Créer un groupe de test" s'ouvre.
2. Saisissez mytestbundle comme nom de groupe de test et appuyez sur Entrée.
  Le groupe de test est créé.
3. Développez le dossier mytestbundle dans la section Apigee pour en afficher le contenu.
Configurez la ressource de test de produit d'API :
1. Placez le curseur sur le fichier products.json dans la section Apigee, puis cliquez sur .
  
  L'assistant de création de produit d'API s'ouvre.
2. Saisissez myproduct comme nom du produit API, puis appuyez sur Entrée pour confirmer et continuer.
3. Saisissez myproduct pour la description du produit d'API, puis appuyez sur Entrée pour confirmer et continuer.
4. Sélectionnez helloworld pour ajouter le proxy d'API au produit d'API, puis cliquez sur OK.
  Le fichier products.json est ouvert dans l'éditeur avec le nouveau produit d'API configuré, comme illustré ci-dessous:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "scopes": [],
    "environments": [],
    "apiResources": [
      "/",
      "/*",
      "/**"
    ],
    "quota": "100",
    "quotaInterval": "1",
    "quotaTimeUnit": "minute",
    "name": "myproduct",
    "displayName": "myproduct",
    "proxies": [
      "helloworld"
    ]
  }
]
```
Configurez la ressource de test pour les développeurs :
1. Placez le curseur sur le fichier developers.json dans la section Apigee, puis cliquez sur .
  
  L'assistant de création d'un développeur s'ouvre.
2. Saisissez les valeurs suivantes à l'invite, puis appuyez sur Entrée pour confirmer et continuer :
  - E-mail de développeur: ahamilton@example.com
  - Nom d'utilisateur: ahamilton
  - Prénom: Alex
  - Nom: Hamilton
  Le fichier developers.json est ouvert dans l'éditeur avec le nouveau développeur configuré, comme illustré ci-dessous:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "email": "ahamilton@example.com",
    "userName": "ahamilton",
    "firstName": "Alex",
    "lastName": "Hamilton"
  }
]
```
Configurez la ressource de test de l'application de développement :
1. Placez le curseur sur le fichier developerapps.json dans la section Apigee, puis cliquez sur .
  
  L'assistant de création d'application de développement s'ouvre.
2. Sélectionnez ahamilton@example.com en tant que propriétaire de l'application.
3. Saisissez les valeurs suivantes à l'ensemble d'invites, puis appuyez sur Entrée pour confirmer et continuer :
  - Nom de l'application: myapp
  - Description: myapp
  - Callback URL (URL de rappel) : laissez ce champ vide.
4. Sélectionnez myproduct pour l'ajouter à l'application, puis cliquez sur OK.
5. Sélectionnez jamais comme valeur d'expiration.
  Le fichier developerapps.json est ouvert dans l'éditeur avec la nouvelle application configurée, comme illustré ci-dessous:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "developerEmail": "ahamilton@example.com",
    "name": "myapp",
    "displayName": "myapp",
    "callbackUrl": "",
    "apiProducts": [
      "myproduct"
    ],
    "expiryType": "never"
  }
]
```
Exportez les ressources de test vers l'émulateur Apigee.
Dans la section Apigee, placez le curseur sur le groupe de test mytestbundle, puis cliquez sur .

Remarque : Si plusieursconteneurs pour l'émulateur Apigee sont en cours d'exécution, vous êtes invité à sélectionner le conteneur dans lequel vous souhaitez déployer l'environnement.

Les ressources de test actives apparaissent dans la section des émulateurs Apigee, comme illustré dans la figure suivante.
Dans la section des émulateurs Apigee, sous "Active test resources" (Ressources de test actives), cliquez sur Active developer apps (Applications de développeur actives).
Le fichier de configuration des applications de développement actives est ouvert dans l'éditeur. Le fichier contient les identifiants de myproduct, comme indiqué dans la figure suivante.
Copiez la valeur consumerKey (sans les guillemets) pour le produit d'API myproduct.
Transmettez la clé API dans votre appel curl à l'aide du paramètre de requête apikey, comme suit:
```
curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY
```
La réponse suivante est renvoyée:
```
Hello, Guest!
```

Félicitations ! Vous avez réussi à exécuter une API dans votre environnement local.

À l'étape suivante, vous allez apprendre à modifier le point de terminaison cible.

1 2 3 4 (ÉTAPE SUIVANTE) Étape 5: Modifiez le point de terminaison cible 6 7 8