Hoe werkt de API? Hoe API in de applicatie te integreren

Application Programming Interface (API) is een van de laatste benodigdheden voor het bouwen van slimme applicaties. Het is een communicatiekanaal tussen twee applicaties. Of u nu bewust bent of niet, u heeft ooit API's gebruikt tijdens het surfen op internet of bij het gebruik van programma's in uw dagelijks leven.

API's sturen vaak complexe gegevens als antwoord, dus hoe kunt u deze informatie begrijpen en gebruiken om uw gebruikers van dienst te zijn? API's maken het leven gemakkelijk voor zowel ervaren ontwikkelaars als mensen die net beginnen. U moet dus weten hoe u ze met uw toepassing kunt gebruiken.

Laten we met enkele gebruiksscenario's en voorbeelden kijken hoe u als ontwikkelaar API's kunt gebruiken om uw programma's te bedienen.

Wat is API?

API's bieden een manier waarop afzonderlijke programma's met elkaar kunnen communiceren

API's bieden een manier waarop afzonderlijke programma's met elkaar kunnen communiceren. API's definiëren de verzoeken die kunnen worden gedaan, hoe de verzoeken worden gedaan en maken gegevensuitwisseling tussen verschillende softwareapplicaties mogelijk.

API's zijn er in 3 typen: openbaar, privé en partner. Openbare API's (of open API's) zijn openbaar toegankelijk voor elke ontwikkelaar. Het gebruik van openbare API's brengt enkele beperkingen met zich mee, en deze kunnen gratis of commercieel zijn. Private API’s worden uitsluitend binnen een bedrijf of organisatie gebruikt. Partner-API's zijn alleen beschikbaar voor specifieke zakenpartners en worden meestal gebruikt om software-integratie tussen twee verschillende bedrijven te vergemakkelijken.

Hoe werkt de API?

Ontwikkelaars creëren API's als producten die andere ontwikkelaars kunnen dienen. Het doel is om complexe webontwikkelingsprocessen eenvoudiger, efficiënter en sneller te maken voor consumentenontwikkelaars of bedrijven.

De meeste bedrijven zijn nu afhankelijk van API's van derden om problemen op te lossen en hun klanten beter van dienst te zijn. Het gebruik van de API is echter niet zo ingewikkeld als veel mensen denken. Je kunt het zien als een oplossing van derden, die je een specifiek antwoord geeft in de vorm van gegevens, wanneer je een specifiek HTTP-verzoek doet.

Het gebruik van de API is als bestellen bij een pizzarestaurant. Je kunt niet naar de keuken gaan om te vertellen wat je wilt. Je hebt een ober nodig om je bestelling op te nemen, deze in de keuken af ​​te leveren en vervolgens terug te komen met de gewenste pizza.

Een API kun je zien als de schakel tussen jou en de keuken. In dit geval bent u een klant die een restaurant bezoekt dat obers ter beschikking stelt (API). De ober reageert dan met uw pizzaselectie (gegevens). In een echte API is de webapplicatie de client die vraagt ​​om de inhoud van de provider via de API te consumeren, door HTTP-eindpuntverzoeken te doen.

Hoe wordt de API gebruikt?

In veel gevallen worden API’s gebruikt

API's worden in veel scenario's gebruikt, waaronder categorieën zoals database-API's, externe API's en web-API's. Waarschijnlijk heeft u meerdere keren per dag interactie met web-API's terwijl u op uw smartphone of computer surft. Web-API's wisselen verzoeken en gegevens uit via het HTTP-protocol.

Reisboekingssites, zoals Skyscanner en Booking.com, gebruiken web-API's om vlucht- en bestemmingsgegevens voor klanten te verzamelen. Het gemak van web-API's maakt het mogelijk om de beschikbaarheid van hotelkamers en de duur van uw verblijf in realtime te bevestigen door uw verzoeken en gegevens van het hotel direct uit te wisselen.

Wat is een API-eindpunt?

Als u verbinding wilt maken met een API, moet u uw programma aansluiten op een API-eindpunt. Je kunt dit beschouwen als een tweerichtingsverbinding. Het eindpunt dat met uw programma is verbonden, verzendt het verzoek, terwijl het eindpunt dat met de API is verbonden u een specifiek antwoord terugstuurt.

Een eindpunt is een aanvraag -URL en biedt de klant directe toegang tot de bronnen van een API.

Naast het ophalen van gegevens met behulp van de API, kun je ook verzoeken van de provider naar de klant POSTen, de PUT-methode gebruiken om meer informatie van de provider te krijgen, en de DELETE-methode gebruiken om bestaande gegevens uit je programma te verwijderen. Elk van deze methoden is doorgaans beschikbaar in de documentatie van de API.

Criteria voor verbinding met API

Het integreren van een API met uw programma is niet zomaar een spontane beslissing; het is met voorbedachten rade. U moet weten welke informatie en hoeveelheid u wilt. Dit helpt de complexiteit te verminderen, vooral als u JSON-gegevens verwerkt als een multidimensionale array. Hiermee kunt u ook de specifieke informatie verkrijgen die u nodig heeft voor uw programma.

Er zijn honderden API's beschikbaar met verschillende regels om er verbinding mee te maken. Hoewel sommige API's gratis en open source zijn, zijn andere alleen toegankelijk op abonnementsbasis.

Hoewel sommige API's naadloos en eenvoudig zijn en geen vereisten vereisen, kan het voor andere API's nodig zijn dat u aan voorwaarden voldoet, zoals het genereren van een API-sleutel of het registreren van een ontwikkelaarsaccount voordat u verbinding kunt maken met het eindpunt.

Een van de belangrijkste aspecten van elke API is echter de documentatie ervan. Het is het beste om de documentatie van elke API waarmee u verbinding wilt maken te lezen en te volgen voor instructies over het coderen en gebruiken van de bronnen ervan. Dat komt omdat elke API zijn eigen verbindingsmethoden en instructies heeft.

Om verbinding te maken met een API moet u ook weten welke programmeertalen deze ondersteunt.

Hoe verbinding te maken met een API: praktijkvoorbeeld

Er is geen specifieke manier om verbinding te maken met de API, maar enkele voorbeelden laten u de basis zien van hoe u API-gegevens kunt gebruiken met uw applicatie.

Laten we eens kijken naar een korte voorbeeldcode over hoe u verbinding kunt maken met een API.

Hoe de Iro.Js Color Picker API te gebruiken

Iro.js is een eenvoudige API waarmee u een gratis kleurkiezer aan uw website kunt toevoegen. Wanneer u een punt op het kleurenwiel selecteert, retourneert de API de hexadecimale of RGB-code van die kleur. Om verbinding te maken met de iro.js API hoeft u alleen maar het CDN-eindpunt (Content Delivery Network) aan het begin van de DOM te plakken.

Volledige documentatie van deze API is beschikbaar op iro.js.org:

https://iro.js.org/guide.html

Laten we eens kijken hoe u verbinding kunt maken met deze API met de onderstaande voorbeeldcode:

Display color picker

In het geval van de bovenstaande voorbeeld-API hebt u geen API-sleutel nodig om er verbinding mee te maken. Laten we, om het beter te begrijpen, JavaScript eens nader bekijken. Om verbinding te maken met deze API, roept u eenvoudigweg de ColorPicker- functie aan vanuit de iro- klasse en geeft u vervolgens de id van de kleurenwielcontainer door aan de klasse.

Het iro.js API-eindpunt is eenvoudig te verbinden, omdat de ontwikkelaars het extra werk hebben gedaan door de laag voor gebruikers te coderen. De onderstaande afbeelding is het resultaat van de bovenstaande voorbeeldcode.

Resultaat van de voorbeeldcode

Om te zien hoe de kleurverandering plaatsvindt, kunt u een ander HTML-bestand openen en de volgende code in het bijbehorende scriptgedeelte plakken:

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

De bovenstaande code registreert hexadecimale kleurwaarden elke keer dat u de positie van de kleurkiezer op het wiel wijzigt.

Hoe u de NoCodeAPI Valutawissel-API gebruikt

NoCodeAPI biedt veel API's, waaronder de API voor valutaconversie. Om verbinding te maken met dit eindpunt voor het wisselen van valuta, gaat u naar NoCodeAPI en maakt u een account aan:

https://app.nocodeapi.com/login

Wanneer u inlogt, ziet u bovenaan de pagina een zoekbalk. Typ valutawissel in die zoekbalk. Wanneer uw zoekopdracht verschijnt, klikt u op Activeren.

Klik op de volgende pagina op Valutawissel-API maken . Voer vervolgens een naam in voor de API en klik op Maken.

Nadat u de API heeft gemaakt, klikt u op Documentatie bekijken. Selecteer vervolgens uw voorkeurstaal om de code te bekijken die verbinding maakt met het API-eindpunt. Vervolgens kunt u die voorbeeldcode kopiëren en in uw app plakken voor verdere aanpassing.

Zie de onderstaande voorbeeldcode voor valutaconversie: