Créer une passerelle API

  • 5 minutes

Les organisations doivent souvent fournir à des partenaires un accès aux données. Cet accès doit être contrôlé et géré.

Dans l’exemple d’entreprise de ventes de chaussures, les détaillants qui stockent des chaussures NorthWind doivent connaître la quantité de stock qu’ils peuvent commander. Les clients aiment également savoir exactement quand ils vont recevoir leur commande.

Ici, vous apprenez comment fonctionne Gestion des API Azure et comment configurer une passerelle d’API.

Gestion des API Azure

Le service de gestion des API Azure est hébergé dans le cloud Azure. Il est positionné entre vos API et Internet. Votre instance de Gestion des API agit comme une passerelle d’API Azure.

Quand vous publiez vos API, vous utilisez le portail Azure pour contrôler comment des API individuelles sont exposées aux consommateurs. Par exemple, vous voulez que certaines API soient disponibles gratuitement pour les développeurs à des fins de démonstration, et que l’accès à d’autres API soit étroitement contrôlé.

Pourquoi utiliser Gestion des API ?

Pour les développeurs, Gestion des API offre différents avantages.

  • Documentation des API. La documentation des API permet aux clients appelants d’intégrer rapidement leurs solutions. Gestion des API vous permet d’exposer rapidement la structure de votre API aux clients appelants via des standards modernes comme OpenAPI. Vous pouvez avoir plusieurs versions d’une même API. Avec plusieurs versions, vous pouvez effectuer les mises à jour des applications par étapes, car vos applications consommatrices ne doivent pas nécessairement utiliser immédiatement la nouvelle version.
  • Accès avec limitation de la fréquence. Si votre API peut potentiellement accéder à une grande quantité de données, il est judicieux de limiter la fréquence à laquelle les clients peuvent demander des données. La limitation de la fréquence permet de conserver des temps de réponse optimaux pour tous les clients. API Management vous permet de définir des limites de fréquence à un niveau global ou pour des clients individuels spécifiques.
  • Supervision de l’intégrité. Les clients distants consomment vos API, il peut donc être difficile d’identifier les problèmes potentiels ou les erreurs. Gestion des API vous permet de visualiser les réponses d’erreur et les fichiers journaux, et de filtrer par types de réponses.
  • Formats modernes, comme JSON. Au fil des années, les API ont utilisé de nombreux formats d’échange de données différents, de XML à CSV et beaucoup d’autres. Gestion des API vous permet d’exposer ces formats en utilisant des modèles de données modernes, comme JSON.
  • Connexions à n’importe quelle API. Dans de nombreuses entreprises, les API se trouvent dans différents pays/régions et utilisent différents formats. API Management vous permet d’ajouter toutes ces API disparates dans une même interface moderne.
  • Analytique. Au fil du développement de vos API, il est utile de voir la fréquence à laquelle vos API sont appelées et par quels types de systèmes. La gestion des API vous permet de visualiser ces données dans le portail Azure.
  • Sécurité. La sécurité est primordiale quand il s’agit de traiter les données des systèmes d’information. Les violations non autorisées peuvent coûter aux entreprises de l’argent, du temps perdu à retravailler le code et une perte de leur réputation. Les outils de sécurité que vous pouvez utiliser avec Gestion des API Azure contiennent l’autorisation utilisateur OAuth 2.0 et l’intégration à Microsoft Entra ID.
  • Niveaux tarifaires. Gestion des API offre des niveaux avec différentes capacités en termes de débit des requêtes, de contrat SLA, d’isolation réseau, de flexibilité des mises à niveau, etc. Quand vous créez une passerelle de gestion des API Azure, vous choisissez le niveau correspondant à vos besoins.

Configuration de Gestion des API

Pour configurer Gestion des API :

  1. Vous créez une passerelle de gestion des API. Le nom que vous utilisez pour la passerelle doit être globalement unique au sein de l’espace de noms .azure-api.net.
  2. Inscrivez une API web existante auprès de la passerelle. L’inscription de l’API la rend disponible pour les consommateurs au point de terminaison <passerelle>.azure-api.net.
  3. Vous appelez l’API existante via la passerelle. Les consommateurs peuvent désormais appeler l’API à l’URL du point de terminaison.