Étape 6 : Publier une API

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

Au cours de cette étape, vous allez publier une API sur le portail en procédant comme suit:
1. Créer une spécification OpenAPI
2. Créer un proxy d'API à partir d'une spécification
3. Créer un produit API
4. Publier l'API sur votre portail

Étape 1: Créer une spécification OpenAPI

Chaque spécification OpenAPI sert de source d'informations tout au long du cycle de vie de l'API. La même spécification est utilisée à chaque phase du cycle de vie de l'API, du développement à la publication.

Pour créer une spécification OpenAPI:

1. Sélectionnez Develop > Specs (Développer > Spécifications) dans la barre de navigation de gauche pour ouvrir la page Specs (Spécifications).
2. Cliquez sur + Spécification > Importer l'URL.
3. Saisissez les informations suivantes dans la boîte de dialogue d'importation:
4. Import name (Nom de l'importation) : helloworld

5. URL d'importation: https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml

6. Cliquez sur Importer.

Étape 2: Créer un proxy d'API à partir d'une spécification

Créez un proxy d'API à partir d'une spécification OpenAPI qui décrit l'API.

Pour créer un proxy d'API à partir d'une spécification OpenAPI, procédez comme suit :

1. Sur la page "Spécifications", placez votre curseur sur la spécification helloworld pour afficher le menu d'actions.
2. Cliquez sur pour générer un proxy d'API à partir de la spécification.
   L'assistant "Créer un proxy" s'ouvre, et la page "Détails" est préremplie à l'aide des valeurs de la spécification OpenGL.
3. Modifiez le champ Description comme suit : proxy d'API pour Hello World.
4. Cliquez sur Next (Suivant).

5. Sur la page Policies (Règles) :

   • Sous Security: Authorization (Sécurité : Autorisation), sélectionnez Pass through (no authorization) (Directe [sans autorisation]).
   • Sous Security: Browser (Sécurité : Navigateur), sélectionnez Add CORS headers (Ajouter des en-têtes CORS).

   

6. Cliquez sur Suivant.

7. Sur la page Flows (Flux), assurez-vous que toutes les opérations sont sélectionnées et cliquez sur Suivant.
   

8. Sur la page "Virtual Hosts" (Hôtes virtuels), vérifiez que tous les hôtes virtuels sont sélectionnés, puis cliquez sur Next (Suivant).

9. Sur la page Summary (Résumé), sélectionnez l'environnement dans lequel vous souhaitez effectuer le déploiement sous Optional Deployment (Déploiement facultatif).

   

10. Cliquez sur Créer.

Sur la page "Résumé", vous verrez un accusé de réception indiquant que votre nouveau proxy d'API a bien été créé et déployé dans votre environnement de test.

Étape 3: Créer un produit API

Créez un produit d'API contenant les ressources d'API que vous souhaitez exposer aux utilisateurs de l'API.

Pour créer un produit API, procédez comme suit :

1. Sélectionnez Publier > Produits API dans la barre de navigation de gauche pour ouvrir la page Produits API.
2. Cliquez sur + Produit API.
   La page New Product (Nouveau produit) s'affiche.
3. Saisissez les détails du produit API.
   Remarque: Les champs "Nom à afficher" et "Description" sont affichés par défaut sur le portail lorsque vous publiez le produit d'API. Vous pouvez modifier les valeurs à l'Étape 4: Publiez l'API sur votre portail.
   

   Champ	Valeur
   Nom	Hello World
   Nom à afficher	Hello World
   Description	Exemple "Hello World" simple
   Environnement	Sélectionnez l'environnement dans lequel le proxy d'API est déployé.
   Accès	Public
   Approuver automatiquement les requêtes d'accès	Activée
   Quota	(laissez le champ vide)
   Champs d'application OAuth autorisés	(laissez le champ vide)

4. Sous Ressources d'API, cliquez sur Ajouter un proxy pour identifier les proxys d'API à ajouter à votre produit d'API.
   La boîte de dialogue Ajouter une ressource d'API s'affiche.
5. Cliquez sur Proxy d'API (si ce n'est pas déjà fait) et sélectionnez Mock-Target-API dans la liste.
6. Cliquez sur Add (Ajouter).
7. Cliquez sur Save (Enregistrer) pour enregistrer le produit d'API.

   

Étape 4: Publiez l'API sur votre portail

Publiez l'API sur votre portail pour permettre à vos clients de se familiariser avec celle-ci et de l'utiliser.

Pour publier l'API sur votre portail, procédez comme suit :

1. Accédez à la page des API de votre portail :
   1. Sélectionnez Publier > Portails dans la barre de navigation de gauche.
   2. Cliquez sur la ligne Mon premier portail pour ouvrir le portail.
   3. Cliquez sur Catalogue d'API pour afficher la page des API.
2. Cliquez sur le signe +.
3. Sélectionnez Hello World dans la boîte de dialogue Ajouter un produit d'API au catalogue, puis cliquez sur Suivant.
4. Sous API details (Détails de l'API), configurez les options suivantes :
   • Sélectionnez Published (listed in the catalog) (Publié [répertorié dans le catalogue]) pour publier l'API sur votre portail.
   • Pour Display image (Image à afficher) :
     1. Cliquez sur Select image (Sélectionner une image).
     2. Cliquez sur home-background.jpg dans la liste des images existantes de la boîte de dialogue Select image (Sélectionner une image).
     3. Cliquez sur Sélectionner.
     4. Prévisualisez l'image et cliquez sur Select (Sélectionner).
   • Pour Categories (Catégories), saisissez Get Started (Premiers pas) et appuyez sur Entrée.

   Conservez toutes les autres valeurs par défaut.

5. Sous API documentation (Documentation de l'API), pour générer automatiquement la documentation de référence de l'API à partir d'un instantané de votre spécification OpenAPI, procédez comme suit :
   1. Sélectionnez OpenAPI document (Document OpenAPI).
   2. Cliquez sur Select Document (Sélectionner un document).
   3. Sélectionnez l'onglet My Specs (Mes caractéristiques) si ce n'est pas déjà fait.
   4. Sélectionnez helloworld dans la liste des spécifications.
   5. Cliquez sur Sélectionner.
6. Cliquez sur Save (Enregistrer) pour enregistrer les détails de l'API.

   

Pour afficher la documentation de référence de l'API, procédez comme suit :

1. Cliquez sur Live Portal (Portail actif) pour afficher les modifications apportées à celui-ci (ou actualisez le portail s'il est déjà ouvert dans un autre onglet).
2. Cliquez sur API dans la barre de navigation supérieure pour afficher l'API publiée.
3. Cliquez sur la fiche Hello World pour afficher la documentation de référence de l'API. Essayez votre API !

---

Félicitations ! Vous avez terminé le tutoriel. Vous souhaitez en savoir plus ? Accédez à la page Créer votre portail intégré.