Waar staat API voor? Voorbeelden van het gebruik van API's

API staat voor "Application Programming Interface". En hoewel dit misschien vreemd klinkt als je nieuw bent in het programmeren, zijn ze gemakkelijk te begrijpen als je het eenmaal hebt opgesplitst. Je gebruikt ze zelfs dagelijks tijdens het bedienen van je mobiele telefoon, pc of tijdens het surfen op internet.

Software, waaronder webapps, mobiele apps en vele andere programma's, verbinden de wereld via internet met elkaar. Maar om dit efficiënter te maken, moet er een communicatiekanaal zijn tussen deze software - daar komt een API om de hoek kijken.

Hier leggen we de betekenis van API's uit en hoe u ze kunt gebruiken.

Wat is een API?

Weet je hoe je video's kunt zien op onder meer streamingplatforms zoals Netflix en YouTube? Het is mogelijk omdat u een verzoek verzendt via een API.

Of heb je je voorgesteld hoe je kunt betalen voor de goederen die je koopt bij online winkels zoals Amazon en eBay? Dat komt ook omdat er een communicatiekanaal is dat bekend staat als een API tussen uw bank en de winkel-apps.

Dat gezegd hebbende, een API is een interface met een reeks regels waarmee de server van uw app kan communiceren met de server van een oplossingsprovider, zodat u hun bronnen kunt gebruiken. In wezen definieert het hoe apps of software met elkaar communiceren.

In sommige gevallen maakt een API echter mutualistische gegevensuitwisseling mogelijk. Een voorbeeld is een verbinding die bestaat tussen uw bank-apps en webwinkel-apps.

Een API is als een boodschapper. Het maakt verbinding met de server van een provider aan de ene kant en verankert ook de server van de klant aan de andere kant. Vervolgens stuurt het het verzoek van de klant naar de gegevensbron (server van de provider) en stuurt het een antwoord terug naar de klant. Een klant hier is de browser of uw app.

Een haak koppelt uw app echter aan de API. Dat is een API-eindpunt. Achter de schermen speelt zich echter veel af. Deze lichten we verder toe.

Hoe API's u helpen apps sneller te ontwikkelen

API's zijn een slimmere tool voor het bouwen van naadloze en robuuste applicaties. Zonder hen zou het bouwen van geavanceerde apps eeuwen duren.

Stel je voor dat je je app nodig hebt om complexe bewerkingen uit te voeren, het type dat veel tijd en moeite kost om te bouwen. En dan komt er iemand met een kant-en-klaar programma dat precies doet wat jij wilt, en mogelijk nog beter.

Maar hoe koppel je dit aan je app? De provider, die zich realiseerde dat dit je misschien wat moeite zou kunnen bezorgen, vertelde je toen dat ze een verbindingsinterface (API) hadden gemaakt die ervoor zorgt dat hun code en die van jou naadloos integreren.

Die interface (API) maakt verbinding met de server die hun code bevat. Vervolgens voedt het u de relevante gegevens van de actie van hun script.

Natuurlijk wil je jezelf niet vervelen met hun hele bronscript. Bovendien vertrouwen de meeste moderne API's nu op gestandaardiseerde REST-technologie (Representational State Transfer). Het maakt ze zeer schaalbaar en eenvoudig te integreren, zonder dat u zich zorgen hoeft te maken over wat er zich binnenin afspeelt of over de status van uw antwoord of verzoek, aangezien ze vooraf zijn geformatteerd.

Dit artikel gaat niet verder in op de REST API. Focus nu op de basis.

Uw code op die van hen aansluiten is een beter idee dan het helemaal opnieuw te schrijven. Om dat te doen, moet u uw code echter koppelen aan de API die ze hebben verstrekt. Hoe doe je dit? Dat is waar een API-eindpunt in beeld komt.

Wat is een API-eindpunt?

Om de zaken te vereenvoudigen, plaatsen de providers vervolgens een URL om de verbinding met hun API naadloos te maken. Zo'n URL is een API-eindpunt. Hiermee kan uw app vervolgens via de API toegang krijgen tot hun server en rechtstreeks met hun script communiceren.

Dus alles wat je hoeft te doen is het eindpunt pakken, het in je code plakken, er verzoeken mee doen, de reacties aanpassen, en dan werkt het, en het is van jou! Een API-eindpunt bindt uw app daarom via een API aan een oplossing of gegevensbron.

Uiteindelijk zijn veel van de programma's die API's aanbieden beschikbaar in verschillende programmeertalen, zodat niemand wordt uitgesloten van het voordeel ervan.

Op die manier kunt u sneller en efficiënter coderen, wetende dat de verantwoordelijkheid voor het onderhouden van de API niet bij u ligt, maar bij de leveranciers van gegevens of oplossingen.

Daarom is een API-eindpunt een communicatiehaak die een API aan de ene kant verbindt met een bronserver en aan de andere kant verbindt met de server van de ontvanger.

Het betekent dan dat je niet het hele script nodig hebt van de oplossing die je wilt gebruiken. Maar uw code kan er geen communicatie mee tot stand brengen als deze geen verbinding maakt met het API-eindpunt.

API-integratieregels

Er is geen vaste regel voor het integreren van een API. Er zijn er een heleboel, en elk van hen heeft zijn integratieregels. Maar houd er rekening mee dat u een reactie telkens wanneer u een verbinding tot stand brengt met een API.

Hoe u verzoeken doet via een API-eindpunt, is meestal gebaseerd op door de provider gedefinieerde regels, maar wat u doet met het antwoord dat u krijgt, hangt af van uw voorkeur. In wezen kun je het draaien zoals je wilt om te voldoen aan de gebruikerservaring en interface van je app.

Soms heb je ook een authenticator nodig voordat je toegang krijgt tot een API. Dergelijke authenticators komen meestal als toegangstokens of API-sleutels. Zodra dit token een authenticatietest doorstaat, signaleert de API het eindpunt om een ​​verbinding tot stand te brengen tussen uw app en de server van de provider.

Als API-consument hoeft u zich geen zorgen te maken over deze parameters, omdat de API-provider ze beschikbaar stelt. Een geweldige API moet in de documentatie ook aangeven hoe u toegang kunt krijgen tot de bronnen en deze kunt gebruiken. Let daar dus altijd op als je er een probeert te integreren.

Om het af te ronden, een API-aanroep draait helemaal om de kopteksten, en eindpunt, de verzoek, en de reactie of de lichaam.

Hoewel we hebben uitgelegd wat een eindpunt is, gaan we deze andere termen verder opsplitsen:

Kopteksten

Gewoonlijk moet u twee vormen van headers beschrijven wanneer u verbinding maakt met een API: de verzoek en de reactie koppen.

De verzoek header is de gateway van een API-aanroep. Het beschrijft de benadering van een klant om toegang te krijgen tot een bron. Het kan details bevatten zoals acceptabel verbindingstype, proxy-informatie en het gegevenstype (JSON, XML of HTML) dat u van de API wilt krijgen.

Zoals we eerder hebben beschreven, moet u, afhankelijk van het type API waarmee u verbinding maakt, mogelijk ook een uniek authenticatietoken in de aanvraagheader opgeven. De provider geeft dit meestal wel.

De antwoordkop, aan de andere kant, is een bewering van de gegevens die afkomstig zijn van de server van de provider. Het geeft uw app informatie over de kenmerken van een provider. In wezen zorgt het ervoor dat uw app toegang verleent tot het antwoord dat afkomstig is van de API.

API-verzoek

Een API-verzoek bevat meestal het eindpunt in een URL (Unique Resource Locator). Het gebruikt het Hypertext Transfer Protocol (HTTP) om het adres te lokaliseren van de bron waartoe u toegang probeert te krijgen met een API. Uiteindelijk is een API-verzoek niet compleet als u het eindpunt niet in de URL opneemt.

API-reactie

Een antwoord is wat een API terugstuurt telkens wanneer het een verzoek van uw app ontvangt. Het kan JSON, XML of HTML zijn, afhankelijk van het gegevens- of inhoudstype dat het van uw aanvraagheader ontvangt.

Zodra u een reactie van een API krijgt, kunt u uw API-aanroep als een succes beschouwen.

API's gebruiken: praktische voorbeelden

Nu je de basis van API's kent en wat je nodig hebt om er een te integreren. Bekijk hoe u een voetbalvoorspelling-API verbindt en integreert van RapidAPI met behulp van Python hieronder.

Het is een eenvoudige API-aanroep die een JSON-antwoord retourneert. U kunt uw code ook in elke teksteditor, en voer het uit via de opdrachtregel.

Verwant: Hoe u uw Python-script uitvoert

Let echter goed op het eindpunt, de inhoud van de request-headers en de response-headers:

importverzoeken
eindpunt = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market":"classic","iso_date":"2021-01-01","federation":"UEFA"}
#Definieer de aanvraagheader:
koptekst = {
'x-rapidapi-key': "Plak hier uw toegangssleutel",
'x-rapidapi-host': "voetbal-voorspelling-api.p.rapidapi.com"
}
#Definieer de antwoordheader:
response = requests.request("GET", eindpunt, headers=headers, params=queryparams)
#Krijg het antwoord:
print (antwoord.tekst)

Blijf leren: Hoe de IPStack API te gebruiken voor het opzoeken van IP-geolocatie

Hoe zit het met het verkrijgen van de huidige temperatuur en vochtigheid van een plaats met behulp van Weatherstack-API met Python? Hier is een voorbeeld hieronder:

importverzoeken
eindpunt = ' http://api.weatherstack.com/current'
koptekst = {
"access_key": "Plak hier uw toegangssleutel",
"query": "Californië"
}
req = requests.get (eindpunt, headers)
res = req.json()
print (u"Huidige temperatuur in %s is %d℃" % 
(res["locatie"]["naam"], res["huidige"]["temperatuur"]))
print (u"Huidige vochtigheid in %s is %d℃" % 
(res["locatie"]["naam"], res["huidig"]["vochtigheid"]))

Typen API's die u kunt integreren

Open-source API's zijn gratis en iedereen kan ze gebruiken. Interne API's bevinden zich binnen een organisatie en alleen apps die bij die organisatie horen, kunnen de resources gebruiken.

U kunt echter ook kiezen voor een dedicated API door een samenwerkingsovereenkomst aan te gaan met een provider. Of u kunt meerdere API's combineren om verschillende problemen op te lossen.

Ook kunnen deze API's, met uitzondering van open-source en interne API's, een prijs hebben, soms variërend van honderden tot duizenden dollars.

App-ontwikkeling vereenvoudigen met API's

Zoals je ziet hoef je geen tijdrovende code meer te schrijven. Als u uw app nodig heeft om complexe bewerkingen uit te voeren, kunt u daar altijd zoeken en een relevante API pakken. Gelukkig zijn ze nu zelfs gemakkelijker te integreren dan de oude conventionele. En als je nieuwsgierig bent en meer wilt weten, er zijn veel gratis API's die je kunnen helpen om je handen vuil te maken.

Hoe API's werken en hoe u ze in uw app kunt integreren

Het gebruik van Application Programming Interfaces (API's) is een essentiële vaardigheid die alle programmeurs moeten beheersen.

Lees volgende

Over de auteur