Què significa API? Exemples de com utilitzar les API

Què significa API? Exemples de com utilitzar les API

API significa 'Interfície de programació d'aplicacions'. I, tot i que això pot semblar estrany si sou nou en programació, són fàcils d’entendre un cop ho descompondreu. Fins i tot els feu servir diàriament mentre feu servir el telèfon mòbil, l’ordinador o mentre navegueu per Internet.



El programari, incloses les aplicacions web, les aplicacions mòbils i molts altres programes, uneix el món a través d’Internet. Però per fer-ho més eficient, hi ha d’haver un canal de comunicació entre aquest programari; aquí és on entra una API.



Aquí explicarem el significat de les API i com utilitzar-les.





Què és una API?

Saps com pots veure vídeos en plataformes de transmissió com Netflix i YouTube, entre d'altres? És possible perquè envieu una sol·licitud mitjançant una API.

O us heu imaginat com podeu pagar els productes que compreu a botigues en línia com Amazon i eBay? Això també es deu al fet que hi ha un canal de comunicació conegut com a API entre el vostre banc i les aplicacions de compra.



Dit això, una API és una interfície amb un conjunt de regles que permeten al servidor de la vostra aplicació interactuar amb el servidor d’un proveïdor de solucions perquè pugueu utilitzar els seus recursos. En essència, defineix com es comuniquen les aplicacions o el programari entre si.

En alguns casos, però, una API permet l’intercanvi de dades mutualistes. Un exemple és una connexió que existeix entre les aplicacions del vostre banc i les aplicacions de la botiga en línia.

Una API és com un missatger. Es connecta al servidor d’un proveïdor per un extrem i també ancla el servidor del client a l’altre extrem. A continuació, atén la sol·licitud del client a la font de dades (servidor del proveïdor) i retorna una resposta al client. Un client aquí és el navegador o la vostra aplicació.

Tanmateix, un ganxo connecta la vostra aplicació a l'API. Aquest és un punt final de l'API. No obstant això, moltes coses es desenvolupen darrere de l’escena. Els explicarem més endavant.

Com les API us ajuden a desenvolupar aplicacions més ràpidament

Les API són una eina més intel·ligent per crear aplicacions robustes i perfectes. Sense ells, la creació d'aplicacions sofisticades trigaria anys.

Imagineu que necessiteu la vostra aplicació per realitzar operacions complexes, del tipus que necessiteu un munt de temps i esforç per construir. I després apareix algú amb un programa ja fet que fa exactament el que voleu i, possiblement, millor.

pujar vídeo HD a Facebook Android

Però, com podeu connectar això a la vostra aplicació? El proveïdor, en adonar-se d’això, us pot suposar problemes, i després us va dir que havien creat una interfície de connexió (API) que fa que el vostre codi i el vostre s’integrin perfectament.

Aquesta interfície (API) es connecta al servidor que conté el seu codi. A continuació, us retroalimentarà les dades rellevants de l'acció del seu script.

Per descomptat, no us voleu avorrir amb tot el seu script font. A més, la majoria de les API modernes confien ara en la tecnologia REST (Transferència d’estats representatius) estandarditzada. Els fa altament escalables i fàcils d’integrar, sense que us hagueu de preocupar del que es desenvolupa ni de l’estat de la vostra resposta o sol·licitud ja que estan preformatats.

Aquest article no anirà més enllà explicant l'API REST. Centreu-vos en els conceptes bàsics per ara.

Connectar el codi al seu és una idea millor que escriure’l des de zero. Per fer-ho, però, heu de connectar el vostre codi amb l'API que han proporcionat. Com ho fas? Aquí és on entra en escena un punt final de l’API.

Què és un punt final de l'API?

Per simplificar les coses, els proveïdors han creat un URL per facilitar la connexió a la seva API. Aquest URL és un Punt final de l'API . Amb ella, l'aplicació pot accedir al seu servidor mitjançant l'API i comunicar-se directament amb el seu script.

Així que tot el que heu de fer és agafar el punt final, enganxar-lo al vostre codi, fer-hi sol·licituds, personalitzar les respostes i, després, funciona i és vostre. Per tant, un punt final de l’API uneix la vostra aplicació a través d’una API a una solució o font de dades.

En última instància, molts dels programes que ofereixen API estan disponibles en diversos llenguatges de programació perquè ningú no quedi exclòs de beneficiar-se’n.

D’aquesta manera, podreu codificar amb més rapidesa i eficiència, sabent que la responsabilitat de mantenir l’API no correspon a vosaltres, sinó als proveïdors de dades o solucions.

Per tant, un punt final de l'API és un ganxo de comunicació que uneix una API a un servidor de recursos en una vora i la connecta amb el servidor del receptor a l'altre extrem.

Aleshores vol dir que no necessiteu tot el script de la solució que voleu utilitzar. Però el vostre codi no hi pot establir comunicació si no es connecta al seu punt final de l'API.

Regles d’integració d’API

No hi ha cap regla difícil per integrar una API. N’hi ha un munt, i cadascun d’ells té les seves regles d’integració. Però tingueu en compte que espereu un resposta sempre que estableixi una connexió amb una API.

La forma de fer sol·licituds a través d’un punt final de l’API sol basar-se en regles definides pel proveïdor, però el que feu amb la resposta que obtingueu depèn de les vostres preferències. En essència, podeu girar-lo com vulgueu per adaptar-vos a l’experiència i la interfície dels usuaris de la vostra aplicació.

De vegades, també necessiteu un autenticador per poder accedir a una API. Aquests autenticadors solen venir com a fitxes d’accés o claus API. Un cop aquest testimoni supera una prova d’autenticació, l’API indica el seu punt final per establir una connexió entre la vostra aplicació i el servidor del proveïdor.

Com a consumidor de l'API, no us preocupeu per aquests paràmetres perquè el proveïdor de l'API els posa a disposició. Una API genial també hauria d’indicar com podeu accedir i utilitzar els seus recursos a la seva documentació. Així que, sempre intenteu-ho, quan intenteu integrar-ne un.

Per arrodonir-lo, es tracta d'una trucada a l'API capçaleres , un punt final , el sol·licitud , i la resposta o el cos .

Tot i que hem explicat què és un punt final, detallem aquests altres termes:

Capçaleres

Normalment, heu de descriure dues formes de capçaleres mentre us connecteu a una API: el sol·licitud i la resposta capçaleres.

El sol·licitud de capçalera és la porta d’entrada d’una trucada API. Descriu l'enfocament d'un client per accedir a un recurs. Pot detallar coses com el tipus de connexió acceptable, la informació del servidor intermediari i el tipus de dades (JSON, XML o HTML) que voleu obtenir de l'API.

Com hem descrit anteriorment, segons el tipus d'API a què us connecteu, és possible que hagueu de proporcionar un testimoni d'autenticació únic dins de la capçalera de la sol·licitud. El proveïdor sol donar-ho.

El capçalera de resposta , d'altra banda, és una afirmació de les dades que provenen del servidor del proveïdor. Ofereix a la vostra aplicació informació sobre les característiques d’un proveïdor. En essència, garanteix que la vostra aplicació concedeixi accés a la resposta que prové de l'API.

Sol·licitud API

Una sol·licitud de l'API normalment conté el punt final en un URL (Unique Resource Locator). Utilitza el protocol de transferència d’hipertext (HTTP) per localitzar l’adreça del recurs al qual intenteu accedir amb una API. En última instància, una sol·licitud d'API no està completa si no incloeu el punt final a l'URL.

com accelerar Windows 10 del disc dur

Resposta API

Una resposta és la que envia una API cada vegada que rep una sol·licitud de la vostra aplicació. Pot ser JSON, XML o HTML, segons les dades o el tipus de contingut que rebi de la capçalera de la vostra sol·licitud.

Un cop obtingueu una resposta d'una API, podeu considerar que la vostra trucada API és un èxit.

Com utilitzar les API: exemples pràctics

Ara que ja coneixeu els conceptes bàsics de les API i el que necessiteu per integrar-ne una. Mireu com connectar i integrar una API de predicció de futbol RapidAPI utilitzant Python a continuació.

És una trucada API senzilla que retorna una resposta JSON. També podeu escriure el vostre codi en qualsevol editor de text i executar-lo mitjançant la línia d’ordres.

Relacionat: Com executar el vostre script Python

Tanmateix, presteu molta atenció al punt final, al contingut de les capçaleres de sol·licitud i de les capçaleres de resposta:

import requests
endpoint = 'https://football-prediction-api.p.rapidapi.com/api/v2/predictions'
queryparams = {'market':'classic','iso_date':'2021-01-01','federation':'UEFA'}
#Define the request header:
headers = {
'x-rapidapi-key': 'Paste your access key here',
'x-rapidapi-host': 'football-prediction-api.p.rapidapi.com'
}
#Define the response header:
response = requests.request('GET', endpoint, headers=headers, params=queryparams)
#Get the response:
print(response.text)

Continuar aprenent: com s'utilitza l'API IPStack per a cerques de geolocalització d'IP

Què tal si feu servir la temperatura i la humitat actuals d’un lloc API Weatherstack amb Python? A continuació teniu un exemple:

import requests
endpoint = 'http://api.weatherstack.com/current'
headers = {
'access_key': 'Paste your access key here',
'query': 'California'
}
req = requests.get(endpoint, headers)
res = req.json()
print(u'Current temperature in %s is %d℃' %
(res['location']['name'], res['current']['temperature']))
print(u'Current humidity in %s is %d℃' %
(res['location']['name'], res['current']['humidity']))

Tipus d’APIs que podeu integrar

Les API de codi obert són gratuïtes i qualsevol persona les pot utilitzar. Les API internes resideixen dins d’una organització i només les aplicacions que pertanyen a aquesta organització poden utilitzar els seus recursos.

Tot i això, també podeu optar per una API dedicada mitjançant la subscripció d’un acord de col·laboració amb un proveïdor. O bé podeu combinar diverses API per resoldre diversos problemes.

A més, aquestes API, excloent les API de codi obert i les internes, poden tenir un preu, que de vegades oscil·la entre centenars i milers de dòlars.

Simplifiqueu el desenvolupament d'aplicacions amb API

Com podeu veure, ja no cal que escriviu codi que consumeixi temps. Si necessiteu que l'aplicació realitzi operacions complexes, sempre podeu buscar allà i obtenir una API rellevant. Afortunadament, ara són fins i tot fàcils d’integrar que les convencionals antigues. I si teniu curiositat i voleu saber-ne més, hi ha moltes API gratuïtes que us poden ajudar a embrutar-vos les mans.

Compartir Compartir Tweet Correu electrònic Com funcionen les API i com s’integren a la vostra aplicació

L’ús d’interfícies de programació d’aplicacions (API) és una habilitat essencial que tots els programadors poden dominar.

Llegiu a continuació
Temes relacionats
  • Programació
  • Programació
  • INCENDI
  • Argot
  • Consells de codificació
Sobre l'autor Idisou Omisola(94 articles publicats)

Idowu és un apassionat de qualsevol tecnologia intel·ligent i productivitat. Durant el temps lliure, juga amb la codificació i canvia al tauler d’escacs quan s’avorreix, però també li agrada deixar de banda la rutina de tant en tant. La seva passió per mostrar a la gent el camí cap a la tecnologia moderna el motiva a escriure més.

Més de Idowu Omisola

Subscriu-te al nostre butlletí

Uniu-vos al nostre butlletí per obtenir consells tècnics, ressenyes, llibres electrònics gratuïts i ofertes exclusives.

Feu clic aquí per subscriure-us