Uit de cursus: Basisbeginselen van programmeren: API's en webservices

Overzicht van REST

- Je hebt misschien de term RESTful API gehoord en je afgevraagd wat dat betekende. REST staat voor Representational State Transfer. Het is een reeks richtlijnen die applicatieontwikkelaars gebruiken om API's te ontwerpen. Om beter te begrijpen hoe een RESTful API werkt tussen de client en de server, laten we een voorbeeld gebruiken. Jane heeft honger en gaat zitten in een restaurant. Dat is een noodzaak. Ze heeft eten nodig. Vervolgens bekijkt Jane het menu, waarin alle opties staan die ze kan bestellen. Het menu is de API. API's hebben een heleboel opties die u kunt bestellen en gebruiken. Nu selecteert Jane haar bestelling, ze wil Kip Parmezaanse kaas, en vertelt het de ober. Bestellen is de API-aanroep. Het is het overbrengen van de boodschap van wat de klant wil dat er gebeurt. De keuken kookt dan het eten. Dit is de API die het werk doet of de benodigde gegevens ophaalt. Uiteindelijk bezorgt de ober het eten bij Jane. Dit is de API-reactie terug naar de client. Ze krijgt wat ze besteld heeft. Nu zijn er vier principes die API's volgen, en laten we ze allemaal bespreken. Als u API's gebruikt, zult u merken dat deze principes uw leven gemakkelijker zullen maken. Ten eerste worden gegevens en functionaliteit in de API beschouwd als bronnen en geïdentificeerd via iets dat de URI of Uniform Resource Identifier wordt genoemd. Deze zijn toegankelijk via weblinks. Ten tweede worden bronnen opnieuw gemanipuleerd met behulp van een vaste reeks bewerkingen. GET haalt een bron op, POST maakt er een, gebruikt PUT om de bron bij te werken en natuurlijk zal DELETE deze verwijderen. Ten derde kunnen bronnen worden weergegeven in meerdere indelingen, zoals HTML, XML, platte tekst en andere indelingen die zijn gedefinieerd door een mediatype. Ten slotte is de communicatie tussen de client en het eindpunt stateless, wat betekent dat de server geen status onthoudt of opslaat over de client die de oproep heeft gedaan. Om beter uit te leggen hoe staatloze principes werken, laten we zeggen dat je in de rij staat bij je plaatselijke coffeeshop en je bestelt je favoriete chai-thee latte. Nadat je hebt betaald en je drankje hebt opgehaald, onthoud je dat je formatteert om er een voor je vriend te bestellen. Dus je staat weer in de rij en vertelt de caissière dat je er nog een wilt. De kassierster herinnert zich uw bestelling niet en u moet haar uw verzoek opnieuw vertellen. In feite bedient ze waarschijnlijk zoveel klanten, dat het voor haar onmogelijk is om alles te onthouden wat iedereen bestelt. Webservices zijn op dezelfde manier. Deze principes zorgen ervoor dat uw RESTful-toepassingen eenvoudig, lichtgewicht en snel zijn.

Inhoud