Que signifie l'interface API ouverte ?

API ouverte, API signifie interface de programmation d'application, API ouverte signifie interface de programmation d'application ouverte. Si nous disons qu'un programme ouvre une API, cela signifie ouvrir une interface pour que les programmes d'autres personnes puissent appeler les données de votre programme. Tout comme votre ordinateur, votre téléphone portable, etc. disposent d'interfaces USB, on peut également dire qu'il s'agit d'interfaces ouvertes. Avec ces interfaces, d'autres peuvent les utiliser pour effectuer des fonctions telles que l'insertion de disques U, le chargement, etc.

Méthodes de développement

Si vous publiez une API ouverte et qu'elle est difficile à intégrer et n'est pas fournie avec pertinent normes, ou des normes attachées mais non adaptées, alors aucun développeur n'utilisera le système. La meilleure façon de garantir que votre API peut être utilisée par d'autres est de l'utiliser dans votre propre application, ce qui est le dicton "construisez-la et utilisez-la".

Décider quelle norme API utiliser est très important car le groupe cible de chaque norme API est très spécifique. Si vous souhaitez prendre en charge un grand nombre d'utilisateurs, utilisez une API simple qui ne nécessite pas beaucoup de surcharge, telle qu'une API RESTful. La norme REST est très large. La meilleure pratique consiste à vous assurer que votre API est cohérente. Par exemple, je n'utilise pas SOAP car c'est trop complexe.

SOAP est le principal protocole de création d'API Web, mais il est trop ancien par rapport à REST et JSON. J'ai constaté qu'avoir JSON comme réponse au lieu de SOAP et XML rend la vie beaucoup plus simple. JSON me permet de renvoyer un format d'objet simple qui peut être analysé dans presque toutes les langues.

Attacher des normes aux API courantes pour l'authentification (telles que OpenID, OAuth et SAML) peut rendre votre API facile à utiliser pour les développeurs et les non-développeurs. Si vous ne gérez pas l'authentification de vos utilisateurs, utilisez une simple authentification basée sur HTTP ou sur un jeton au lieu d'OpenID, OAuth ou SAML, qui sont principalement conçus pour authentifier les utilisateurs.

De plus, il serait avantageux pour les développeurs de fournir une API ouverte et elle-même documentée. J'ai récemment commencé à ajouter la documentation de l'API Swagger à mon API. Swagger permet aux développeurs de générer automatiquement du code pour les API dans plusieurs langues. Si vous ne suivez pas cette approche, vous devez au moins vous assurer de fournir des bibliothèques client API utilisant les langages les plus populaires tels que Java, Node.js, Python, Ruby et le C orienté objet (qui est utilisé pour développer applications mobiles).

La clé est de suivre des principes et des normes logiciels simples. Ne réinventez pas l'API, ne compliquez pas l'authentification.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!