Accéder au contenu principal Passer au contenu complémentaire

Créer l'API

Créez votre API et ses opérations pour les gérer dans Azure. Dans cet exemple, les opérations sont créées manuellement mais vous pouvez également importer une définition d'API depuis Talend Cloud API Designer. Pour plus d'informations, consultez Déployer une définition d'API sur Azure API Management.

Procédure

  1. Ouvrez l'instance DemoREST-APIM que vous avez créée puis cliquez sur APIs > Add API (Ajouter une API) > Blank API (API vide).
  2. Cliquez sur Full (Complet) pour afficher tous les paramètres de votre API et les configurer comme suit :
    Paramètre Valeur
    Display name Saisissez un nom pour votre API, DemoREST-API par exemple.
    Web service URL Saisissez l'URL du service. Dans cet exemple, utilisez l'URL suivante en remplaçant <DemoREST-PublicIP> par l'adresse IP publique associée à l'équilibreur de charge que vous avez créé : http://<DemoREST-PublicIP>:80/services.
    Modèle d'URL Sélectionnez le modèle défini dans l'équiilibreur de charge, HTTP dans cet exemple.
    Suffixe de l’URL de l’API Saisissez le suffixe à ajouter à votre URL de l'API, services dans cet exemple.
    Products (Produits) Sélectionnez un produit, Starter par exemple. Cette action est requise si vous voulez publier votre API.
  3. Cliquez sur Create.

    Exemple

    Menu Create a blank API (Créer une API vide).
  4. Allez dans l'onglet Settings (Paramètres) de votre API, descendez jusqu'à Subscription (Abonnement). Décochez la case Subscriprion required (Abonnement requis) puis cliquez sur Save (Enregistrer).
  5. Allez dans l'onglet Design (Conception) et cliquez sur Add operation (Ajouter une opération).
  6. Configurez votre première opération comme suit :
    Paramètre Valeur
    Display name Saisissez un nom pour votre opération, Get all customers par exemple.
    URL Gardez la méthode GET par défaut. Saisissez l'endpoint que vous souhaitez pour votre opération, /customers dans cet exemple.
    Description Saisissez une description pour cette opération.
    Tags (Étiquettes) Saisissez un mot-clé pour votre opération, customers par exemple.
  7. Cliquez sur Save (Enregistrer).
  8. Cliquez sur Add operation (Ajouter une opération) pour créer une opération.
  9. Configurez votre seconde opération comme suit :
    Paramètre Valeur
    Display name Saisissez un nom pour votre opération, Get a single customer par exemple.
    URL Gardez la méthode GET par défaut. Saisissez l'endpoint que vous souhaitez pour votre opération, /customers/{id} dans cet exemple.

    Un paramètre id est automatiquement créé dans l'onglet Template (Modèle).

    Description Saisissez une description pour cette opération.
    Tags (Étiquettes) Saisissez un mot-clé pour votre opération, customers par exemple.
  10. Dans l'onglet Template (Modèle), saisissez une description pour le paramètre id, Customer ID par exemple.

    Exemple

    Dans le menu APIs (API) de l'API DemoREST-API, le nouveau paramètre id est disponible dans l'onglet template (modèle).
  11. Cliquez sur Save (Enregistrer).

Résultats

Vous avez créé une API avec deux opérations. Vous pouvez la tester en utilisant sa nouvelle URL de base.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.