API, un acronyme interface de programmation d'application (interface de programmation d'application) pour l'outil de ligne de commande pour Java, Ruby on Rails, programme d'application Web. À moins que vous écrivez chaque ligne de code à partir de zéro, ou vous interagir avec les composants logiciels externes, chacun avec sa propre API. Même si vous écrivez quelque chose de complètement à partir de zéro, une des applications logicielles bien conçues auront une API interne pour aider à organiser le code, et des composants réutilisables est plus élevé.

Un regard plus profond, l'API est une forme de composants standardisés qui interagissent avec le logiciel. Par exemple, si une voiture est un composant logiciel qui API inclut la capacité de freiner et tourner à la radio des informations sur l'accélération. Il comprend également des informations sur la façon d'accélérer: Mettez votre pied sur la pédale d'accélérateur et de carburant. API définit le « quoi » et « comment » de l'information se réunissent, il est un résumé de la voiture elle-même.

Une chose à retenir est que les noms de certaines API est généralement utilisé pour faire référence à la génération actuelle de spécification composant logiciel interactif et d'interagir avec. Par exemple, « API Twitter. » Cette phrase fait référence non seulement par programmation interagissez avec le ruleset Twitter, mais on entend généralement interagir avec votre contenu, tels que « nous analysons obtenus à partir des tweets de l'API Twitter. »

L'étude approfondie de l'API Java par Let et API Twitter comme un exemple. Tout d'abord, nous allons comprendre rapidement les deux API et de définir la façon dont ils mettent en uvre « quoi » et « comment » de. Ensuite, nous discuterons lorsque vous pouvez utiliser l'API et comment API bien conçu.

API Java

Java API est un « hors de la boîte » bibliothèque de composants de logiciel, disponible pour quiconque d'installer l'utilisation Java Development Kit. Ces composants effectuer des tâches courantes, améliore la productivité en général, parce que le programmeur ne doit pas repartir de zéro à chaque fois. Un composant de base du logiciel utilisé est ce qu'on appelle la liste, comme on peut s'y attendre, il peut suivre la liste des éléments. Java API définit les opérations que vous pouvez effectuer sur la liste: articles ajouter, trier la liste pour déterminer si la liste des projets au milieu. Il précise également comment effectuer ces opérations. Pour trier la liste, vous devez spécifier comment trier la liste: par ordre alphabétique, numérique décroissant, les plus brillants à la couleur la plus foncée.

OpenJDK API documents méthode de classement sur la Liste Sur la photo. comparateur consiste à déterminer comment trier une liste de paramètres.

API Twitter

Twitter API est une API JSON basée sur le Web, permet aux développeurs d'interagir par programme avec les données Twitter. Et l'API Java inclus dans le kit de développement Java différent, API Twitter est une API basée sur le Web. Doit demander au service de Twitter peut y accéder via Internet.

Votre application envoie une requête HTTP comme le navigateur Web comme une API basée sur le Web (tels que Twitter). Cependant, les pages de réponse offrent, non pas pour la compréhension humaine, mais revient à l'application peuvent être facilement le format parsés. A cet effet, il existe une variété de formats, Twitter utilisation JSON appelé format populaire et facile à utiliser.

L'un des éléments de base de Twitter dans un tweet. Twitter API peut vous dire quoi faire avec les tweets: recherche tweets, créer des tweets, les tweets préférés. Il vous indique également comment effectuer ces opérations. Pour rechercher tweets, vous devez spécifier des critères de recherche: Pour une entrée de sujet ou tag, situation géographique, la langue et ainsi de suite.

La figure est la recherche Twitter documentation de l'API. Vous trouverez tous les détails nécessaires pour les groupes de tweets de requête, y compris les opérateurs de recherche disponibles et format de réponse.

API REST

Twitter API et beaucoup d'autres API Web est un exemple d'une API REST, ce qui signifie qu'il est (Representational State Transfer REST) style architectural en utilisant l'API. REST par Roy Fielding dans sa thèse de doctorat en 2000 a présenté officiellement, il est utilisé pour construire un ensemble de composants architecturaux impliqués dans tout type de média (texte, vidéo, etc.) des systèmes distribués, les principes de conception et de l'interaction. Le noyau est un style de construction système REST qui permet une flexibilité dans un réseau pour communiquer des informations et d'affichage, tout en fournissant le bâtiment structurelles nécessaires des composants communs.

Dans l'API REST, la ressource peut être presque tout, y compris les utilisateurs des exemples, des tweets, et la liste actuelle des tweets de résultats de recherche. Chacune de ces ressources peut être effectuée par un identifiant de ressource d'adressage des ressources, pour l'API REST basée sur le Web, généralement une URL, comme https://api.twitter.com/1.1/users/show?screen_name=twitterdev. Lorsqu'une demande d'application L'utilisation de l'identifiant de ressource, l'API sera utilisé par le format d'application (telles que les images JPEG, page HTML ou JSON) montrant la forme de ressources de transmission à l'application en cours.

L'une des plus grande différence est qu'il implique des données REST à l'application demandeuse. Bien que cela offre une grande flexibilité, mais permet aux applications d'effectuer toute action fondée sur les données, ce qui est au détriment du coût de l'efficacité. Traitement des données transmises par le réseau en ce qui concerne les données résidant processus plutôt lent, et transmet ensuite le résultat. Bien sûr, l'approche « efficace » est que le problème des applications de données gérées du système ont besoin de savoir ce qui doit être fait à l'avance. Par conséquent, afin de construire une facilité d'utilisation de l'API universelle et la flexibilité, le reste est un chemin praticable.

Comme l'API de couche d'abstraction

En parlant de logiciel, API presque partout. API est l'un des concepts les plus fondamentaux de la science informatique sont parallèles: résumé. Résumé complexité du système est seulement une méthode de tissu, de sorte que les opérations complexes de manière simple. Imaginez cette abstraction, comme Amazon bouton Dash, vous pouvez l'utiliser pour commander les agrafes Amazon. C'est ce qu'ils ressemblent à:

Quelques exemples du bouton Dash Amazon figure. Appuyez sur le bouton pour commander plus de détergent ou des serviettes en papier.

Vous pouvez commencer à commander sur Amazon bouton Dash et utiliser l'application sur le smartphone pour l'associer à votre réseau Wi-Fi, compte Amazon et produit (par exemple, votre marque préférée de serviettes en papier). Ensuite, si vous souhaitez commander plus de serviettes en papier, vous appuyez simplement sur le bouton Dash pour se connecter à Internet et envoyer des messages à votre compte dans l'ordre de haut en bas. Quelques jours plus tard, des serviettes en papier arrivent à votre porte.

Comme une API, bouton Dash est une interface très simple qui cache la complexité derrière les coulisses. Votre commande produits d'identification doivent être récupérées à partir d'une base de données. Votre adresse de livraison doit être extrait de votre compte. Vous devez déterminer le centre de la conformité des tissus du stock le plus proche, puis informe l'article est retiré de ses stocks existants emballages. Enfin, le paquet doit être en mesure d'assurer efficacement que tous les colis arrivent par avion, camions et fourgonnettes, ainsi que d'une combinaison d'autres paquets.

Supposons maintenant que vous en tant que client doivent coordonner toutes ces choses, alors vous ne commander une serviette en papier, car il était trop compliqué, trop de temps, et vous avez plus de choses à faire. Heureusement, l'ensemble du test est extrait de votre corps. Il y a un système informatique liés entre eux à long terme et le personnel d'écoulement entre la chaîne, de sorte que ces serviettes en papier apparaissent sur votre porte, mais vous suffit d'appuyer sur le bouton. Ceci est l'API du programmeur, ils résolvent beaucoup de complexité et définit un ensemble peuvent tirer profit des interactions relativement simples, plutôt que d'essayer de faire tout le travail. Dans tout projet de logiciel, vous êtes susceptible d'utiliser directement des dizaines ou des centaines même de l'API, l'API et dépendent les uns des autres API et ainsi de suite.

API Conception

la conception de l'API est le processus de développement API « quoi » et « comment » de. Comme avec tout autre contenu peut être créé, la conception de l'API prendra en compte les différents niveaux de réflexion et d'attention, ce qui dans les différents niveaux d'API de qualité. API bien conçu avec un comportement cohérent, compte tenu de leur contexte, et en tenant compte des besoins des utilisateurs.

L'API comportement cohérent influence grandement la probabilité de ses erreurs de vitesse d'apprentissage et programmeur lors de l'utilisation. En règle générale, l'API devrait effectuer des opérations similaires ont un comportement similaire, quelles que soient leurs différences techniques. Par exemple API incohérents, le regard let à deux façons d'ajouter Java la liste des éléments:

Ajouter des éléments à la liste, même si les deux méthodes effectuent la même opération, leurs types de retour (nuls et valeurs booléennes) sont différentes. L'utilisation de cette API, les développeurs ont maintenant de garder une trace de méthode quel type de rendement, ce qui rend plus difficile d'apprendre l'API et son utilisation est plus sujette à l'erreur. Cela signifie également que ces méthodes en utilisant le code devient moins souple, parce que si vous voulez ajouter un moyen d'éléments de commutation, il doit être changé.

Compte tenu du contexte est une autre forme de cohérence, même si elle est liée à l'API de facteurs externes. Un excellent exemple de la façon dont les règles non-logiciels de la route sur le côté droit ou gauche de la réglementation de la circulation routière affectant différents pays en matière de conception automobile. Lorsque le siège du conducteur sur le côté droit ou le côté gauche de la voiture, les concepteurs de la voiture prendra en compte les facteurs environnementaux.

Dans la conception de l'API, en tenant compte du contexte signifie généralement que vous respectez les meilleures pratiques généralement acceptées, et l'inspiration de gain d'autres utilisateurs que vous connaissez peut-être avec l'API. Supposons que vous construisez une nouvelle liste fournit une bibliothèque pour les applications Java, peut-être un outil conçu pour de très grandes listes. Liste des API devrait être possible de contenir une méthode d'ajout, son comportement et ses méthodes de travail Java Liste méthode add est le même. De cette façon, les utilisateurs peuvent facilement adopter votre bibliothèque, car ils savent déjà comment l'utiliser.

Connaissez vos utilisateurs et garder à l'esprit leurs besoins est essentiel dans la conception de l'API. Si vous comprenez leurs points de douleur et de les aider à éviter la douleur, alors vous aurez le plaisir des utilisateurs de l'API. Pour la même raison, vous pouvez choisir de violer d'autres règles de bonne conception de l'API. Si vous écrivez API Web, puis aujourd'hui la norme de facto est d'utiliser JSON comme format d'échange. Toutefois, si votre API Récupération utilisateur scientifique un grand nombre de données pour fournir des services, ce serait trop long et fastidieux JSON les servir. Ainsi, vous pouvez choisir d'utiliser le format binaire GRIB comme celui-ci, même si elle est dans un sens général est un choix très rare.

API est une partie importante de la conception de logiciels, ils existent dans tous les niveaux de la pile logicielle. Ils fournissent un moyen de définir abstraite et de la gestion, dites-nous ce que nous pouvons faire avec les composants logiciels et comment le faire. support API bien conçu efficace, lisse et facile à adopter et à utiliser, et l'API mal conçu provoque un mal de tête chaque fois que vous utilisez.