Passer au contenu principal

Gestion des APIs

Outils et capacités pour contrôler et gérer vos APIs et le cycle de vie de ces API.

Qu'est-ce que c'est?

La gestion des APIs est, d’un point de vue technologique, une suite d’outils qui permet aux organisations de déployer et de gérer des APIs. Plus généralement, il est la capacité qui permet à une organisation de contrôler et régissent son domaine d’APIs et le cycle de vie associé de ces APIs. Il y a 5 fonctionnalités clés typiques que nous nous attendons à voir dans une technologie de gestion d’APIs:

  • Le portail des développeurs – Attirer et engager les développeurs.
  • L’API Gateway – Sécuriser et assurer la médiation du trafic entre les consommateurs d’APIs et les services backend.
  • La gestion du cycle de vie des APIs – Gérer le processus de conception, de développement, de publication, de déploiement et de contrôle de version des APIs.
  • L’analytics – Fournir des informations sur l’utilisation pour les propriétaires de produits, les administrateurs et les développeurs.
  • La monétisation des APIs – Permettre aux fournisseurs de créer un package, de fixer le prix et de publier leurs APIs.

La technologie de gestion des APIs peut être acquise ou engagée de plusieurs façons:

  • La technologie basée sur un abonnement pour fonctionner sur site ou dans le cloud (WSO2, Kong HQ, Mulesoft, Axway).
  • La technologie basée sur la consommation (Microsoft Azure, Amazon, Google Apigee).
  • La technologie open source (Kong, Google Apigee, Gravitee.io).

Quelle que soit la voie que vous empruntez pour acquérir la technologie, comprendre sa valeur pour l’organisation devrait rapidement devenir évidente pour toutes les personnes impliquées.

Proposition de valeur de la capacité

Lorsqu’une organisation s’engage dans la production d’APIs destinées à être consommées par les développeurs, il doit devenir clair que la réalisation et le maintien de la consommation doivent être l’objectif ultime de l’entreprise. Cela est particulièrement vrai lorsqu’une organisation se concentre sur la monétisation des APIs. Le portail des développeurs est la clé de la consommation. La documentation qu’il fournit, et la qualité de cette documentation, sous-tendent le succès des développeurs dans la consommation des APIs.

Les fonctionnalités de gestion du cycle de vie des APIs sont essentielles pour garantir que ce qui arrive sur le portail des développeurs est propre à la consommation. Les APIs ne sont généralement consommées que si la conception de l’APIs se prête à la consommation. L’exception à cela est si la valeur des données sous-jacentes l’emporte sur les besoins d’une bonne conception. Cela dure tant qu’il n’y a pas de jeu de données concurrent ou de valeur comparable ailleurs. Là où une valeur comparable existe ailleurs, l’expérience de l’API devient déterminante.

Les fonctionnalités de monétisation des APIs permettent aux organisations de conditionner leurs APIs en tant que produits. De plus en plus, les APIs ont des chefs de produit. La définition des abonnements aux produits, des clés APIs, etc. est la clé de la monétisation de l’API. L’analyse nous permet de comprendre le succès de nos APIs ainsi que de les dépanner et de les gérer de manière opérationnelle. La passerelle ou gateway d’APIs est le pont entre l’API et les services backend auxquels ils se connectent. Nous permettant de sécuriser et de négocier le trafic entre le consommateur et les services de données.

La proposition de valeur d’une technologie de gestion des APIs est de rassembler tout cela en un tout cohérent. Non seulement en rassemblant les composants techniques et les fonctionnalités, mais aussi les parties prenantes qui font d’une initiative / mise en œuvre de gestion des APIs un succès.

Les cas d'utilisation

La gestion des APIs est normalement implémentée en tant que point focal des initiatives d’APIs. C’est la couche de présentation ou la façade pour le développement ailleurs sur les APIs. Cela peut prendre la forme de développement de microservices, de développement d’intégration ou de façade au-dessus d’une application existante ou des APIs d’un système. Il permet aux organisations de regrouper toutes ces activités dans un «guichet unique» d’API au sein de l’organisation.

Les initiatives qui se produisent derrière une technologie de gestion des APIs visent généralement à répondre à un besoin fonctionnel. La couche de gestion des APIs vise à répondre aux besoins de consommation tels que:

  • Documentation précise ou contrats APIs
  • Authentification et sécurité cohérentes.
  • Gestion du cycle de vie et gestion des versions.
  • Capacité de médiation et de surveillance de la consommation d’APIs.
  • Comprendre les API en tant que produits de consommation.

Le dernier point est probablement le plus important en termes de consommation. Si nous voulons que les APIs soient utilisées ou consommées, nous devons regarder au-delà du besoin fonctionnel et voir l’API comme un produit. De nombreuses organisations considèrent leurs implémentations de gestion des APIs comme une simple passerelle ou un proxy, c’est-à-dire en termes fonctionnels. Les organisations les plus performantes dotées de la technologie de gestion des APIs le considèrent comme un produit, même si ce produit ne concerne que la consommation interne de l’organisation.

Les meilleures pratiques de mise en œuvre

La fin de la gestion des APIs d’une implémentation est souvent distincte des autres activités de développement qui se trouvent derrière elle. Il serait également raisonnable de s’attendre à ce que cela vienne après ces activités dans la planification du projet. Cependant, si une organisation pense et conçoit en termes de consommation, elle devrait vraiment prioriser les activités de gestion des APIs à l’avance. Concevoir pour la consommation. Lorsque nous pensons à la gestion des APIs, nous considérons généralement les rôles de concepteur, de développeur et d’administrateur d’APIs. Nous devrions envisager d’affecter un propriétaire de produit ou un chef de produit à l’API. Responsable de sa feuille de route et convenir de son ensemble de fonctionnalités avec les principales parties prenantes.

Les développeurs d’intégration se retrouvent souvent après la livraison d’un processus d’intégration en construisant un contrat d’APIs (définition Swagger) pour le service qu’ils ont développé. Cela devrait vraiment se produire dans le cadre d’une activité de conception d’intégration. Documenter le contrat d’APIs à l’avance, concevoir les schémas de données et réfléchir à la manière dont le processus sera ou peut être utilisé. Nous devons éviter de créer un produit dans un portail d’éditeur d’APIs pour affecter l’obtention d’une clé d’abonnement pour l’authentification à la fin de la livraison. Nous devrions penser au produit dès le départ et aux abonnements probables et aux cas d’utilisation requis pour ce produit.

Comment ces technologies se différencient-elles?

Au-delà des 5 fonctionnalités clés que nous nous attendons à voir dans un produit de gestion des APIs, nous pouvons voir une différenciation des produits en termes de fonctionnalités supplémentaires ou de forces particulières dans certains domaines. Intégration avec des systèmes de facturation d’abonnements comme Stripe par exemple pour la monétisation. Combinaison de capacités de gestion des APIs avec des capacités d’intégration pour permettre le chaînage de services. Nous pouvons également voir une force particulière dans les outils de conception d’API ou la qualité globale de l’expérience du portail des développeurs.

L’autre domaine clé de différenciation dans la gestion des APIs est la façon dont une organisation paie pour cela. Cela peut affecter l’adoption globale d’une technologie. Une implémentation open source peut rapidement répondre aux besoins fonctionnels d’une organisation. Cependant, un manque d’investissement et une analyse de rentabilisation préalable à cet investissement peuvent ne jamais voir les APIs considérées comme des produits de valeur au sein de l’organisation. Un investissement initial dans une technologie basée sur l’abonnement peut forcer une organisation à réfléchir plus sérieusement à la valeur au-delà des fonctionnalités. De même, en ce qui concerne les modèles de tarification basés sur la consommation, notre coût de consommation s’accumule-t-il à la fin de l’utilisation des APIs?

Les considérations

Le quand et le pourquoi de la gestion des APIs peuvent être différents d’une organisation à l’autre. Il existe de nombreuses façons de générer et de fournir des APIs. En règle générale, une organisation va avoir, ou prévoit d’avoir, un nombre significatif d’APIs avant d’investir dans ce type de technologie. Le point important à réitérer est que nous devrions penser au-delà du besoin fonctionnel à une initiative ou une stratégie de gestion des APIs.

Les organisations devraient penser aux rôles au sein de l’organisation que la technologie prend en charge autant qu’aux besoins fonctionnels auxquels elle répond. Si nous ne pensons pas en termes de concepteurs d’APIs, de développeurs, d’administrateurs et de propriétaires de produits, est-ce bien la technologie que nous recherchons? Si vous avez juste besoin d’une documentation et d’une capacité de conception solides, il s’agit peut-être d’un service de type Apiary ou SwaggerHub que l’organisation devrait envisager.

Voilà pourquoi Chakray?

Chakray a une vaste expérience de travail avec un certain nombre de technologies de gestion des APIs sur le marché, notamment WSO2, Amazon AWS, Microsoft Azure, Kong HQ, Gravitee.io et Traefik Labs. Plus important encore, notre connaissance de la discipline de la conception, du développement, du déploiement et de la gestion des APIs au sein de ces technologies génériques. Cela nous permet de travailler avec des clients dans le monde entier, dans tous les secteurs et technologies sur leurs initiatives de gestion des APIs.

Peut-être que ça peut vous intéresser…

Plus d'informations et de lecture sur des sujets liés à cette page

Ebook

Gestion des APIs: accélérez la croissance de votre entreprise avec des APIs ouvertes

Développez votre entreprise avec des APIs open source Dans ce livre électronique, nous montrons ce que c'est et comment développer et développer

Boomi VS Workato
Shwetha Mahendran
Technical Researcher

Talk to our experts

Parlez-nous des capacités que vous cherchez pour mettre en œuvre ou à améliorer dans votre organisation

Contactez-nous