REST of RESTful API's zijn tegenwoordig overal. Je hebt het misschien zelfs gebruikt zonder er iets van af te weten.  In dit artikel zal ik het hebben over REST API's. Ik zal bespreken hoe ze werken, hun toepassingen en nog veel meer. Laten we beginnen.

Waarom REST API GEBRUIKEN:

In traditionele webapplicaties, laten we zeggen een eenvoudige PHP-webserver,

• Je vraagt ​​een pagina aan (laten we zeggen php) van de server.
• De server vindt het scriptbestand (php) correspondeert met de pagina die u hebt opgevraagd en begint deze uit te voeren. Het script maakt verbinding met de database, zoekt naar de vereiste informatie, plaatst de informatie in de pagina op een mooi opgemaakte manier (HTML + CSS + JavaScript mengen met de gegevens) die er erg aantrekkelijk uitziet voor de bezoeker.
• Vervolgens stuurt de server het terug naar de bezoeker.

In dit model wordt alle verwerking aan de serverkant gedaan. Dus de server moet meer werk doen. Hier staan ​​gegevens niet los van de pagina, maar zijn ze diep in de pagina ingebed.

Als je in de toekomst een Android-app of iOS-app of een Desktop-app van je website wilt maken, zul je veel meer werk moeten verzetten. U moet rechtstreeks vanuit elk van deze apps verbinding maken met de database, wat mogelijk niet erg veilig is. De ontwikkeltijd zal toenemen en er zullen problemen met de portabiliteit ontstaan.

Stel dat u met succes desktop-, Android- en iOS-apps van uw website heeft gemaakt. De volledige naam van de gebruiker wordt weergegeven in kleine letters in elk van hen. Nu wil je het in hoofdletters tonen. Welnu, de ontwikkelaars moeten de desktop-, Android- en iOS-versie van uw app afzonderlijk wijzigen om dat te doen. Wat is tijdrovend. In de echte wereld zullen de dingen niet zo eenvoudig zijn als deze. Dus één versie van de app (laten we zeggen de desktopversie) heeft mogelijk een ernstige fout in het updateproces. Het later repareren zou meer tijd kosten. Kun je zien hoe de ontwikkeltijd toeneemt?? Deze oplossing is ook niet draagbaar.

In REST API vraag je de API-server wat je nodig hebt en het stuurt je alleen de informatie waar je om vraagt, er wordt geen extra opmaak gedaan in de server. Er is geen noodzaak voor onnodige verwerking in de server. De prestaties van uw website en apps worden dus natuurlijk verbeterd. U kunt dezelfde gegevens ook gebruiken in uw website, desktop-app, Android- en iOS-apps. Wijzigingen aan de servers worden weerspiegeld in de apps die de API gebruiken. De ontwikkeltijd en kosten van de app worden ook verminderd.

Hoe REST API werkt:

De REST API's hebben eindpunten. Een eindpunt is niets meer dan een URL, maar op een mooi geformatteerde manier en het is zinvol. Het gebruikt de native HTTP-verzoeken (zoals: KRIJGEN, POST, LEGGEN, VERWIJDEREN enz.) om te beslissen wat u moet doen wanneer u toegang krijgt tot elk eindpunt. Ik zal hier later over praten.

Het uitvoerformaat van de REST API is JSON, ook bekend als JavaScript Object Notation.

Een voorbeeld van de uitvoer van a KRIJGEN verzoek aan de REST API op /gebruikers/id/12 eindpunt kan er als volgt uitzien:

"id": 12,
"naam": "David Smit",
"leeftijd": 42,
"telefoons": ["124-211-2341", "889-211-4545"],
"land": "VS"

Zoals je kunt zien, heb ik een KRIJGEN aanvraag op /gebruikers/id/12 eindpunt om de REST API te vertellen om mij informatie te geven over de gebruiker die de . heeft ID kaart 12. Ik heb precies de informatie gekregen waar ik om vroeg, niets meer en niets minder.

Stel nu dat u informatie wilt over de laatste 10 gebruikers die zich op uw website hebben aangemeld. Je mag een KRIJGEN aanvraag op /gebruikers/laatste/10 eindpunt.

U kunt ook nieuwe gegevens op uw server toevoegen met behulp van de REST API. Meestal is de HTTP POST request wordt gebruikt om de REST API te vragen om nieuwe gegevens toe te voegen aan de API-server.

U kunt bijvoorbeeld een POST aanvraag op /gebruikers eindpunt met de gegevens van de nieuwe gebruiker en het wordt toegevoegd aan de database op uw API-server. U kunt uw API ook configureren om de status van het verzoek te retourneren.

"statusCode": 400,
"statusText": "Gebruiker succesvol toegevoegd.",
"gegevens":
"id": 13,
"naam": "Mary Smith",
"leeftijd": 35,
"telefoons": ["124-211-2341", "889-211-4545"],
"land": "VS"

Zoals je kunt zien, is de status code en statusTekst eigenschap van het JSON-object meldt de API-client dat de gebruiker is toegevoegd. De toegevoegde gegevens worden ook geretourneerd in de gegevens eigenschap van het JSON-object. U kunt uw API precies zo configureren als u wilt.

U kunt ook een bestaand record bijwerken vanuit de database van de API-server. De LEGGEN HTTP-verzoek wordt gebruikt op een API-eindpunt om bestaande gegevens in de database van uw API-server bij te werken.

Laten we bijvoorbeeld zeggen dat u het telefoonnummer van de gebruiker wilt bijwerken met de id 13. Je mag een LEGGEN verzoek op het API-eindpunt /gebruiker/id/13.

"statusCode": 200,
"statusText": "Gebruiker bijgewerkt.",
"old_data":
"id": 13,
"naam": "Mary Smith",
"leeftijd": 35,
"telefoons": ["124-211-2341", "889-211-4545"],
"land": "VS"
,
"nieuwe data":
"id": 13,
"naam": "Mary Smith",
"leeftijd": 35,
"telefoons": ["100-211-1111", "140-211-1145"],
"land": "VS"

Zoals u kunt zien, is de update-bewerking geslaagd. De oude gegevens en nieuwe gegevens worden geretourneerd in de oude_data en nieuwe data eigenschap van respectievelijk het JSON-object.

U kunt ook gegevens uit de database van de API-server verwijderen met de HTTP VERWIJDEREN verzoek op het API-eindpunt.

Als u bijvoorbeeld de gebruiker met de id 12 wilt verwijderen, kunt u het volgende doen: VERWIJDEREN verzoek op het API-eindpunt /gebruiker/id/12.

"statusCode": 150,
"statusText": "Gebruiker verwijderd.",
"gegevens":
"id": 12,
"naam": "David Smit",
"leeftijd": 42,
"telefoons": ["124-211-2341", "889-211-4545"],
"land": "VS"

Zoals u kunt zien, wordt de gebruiker verwijderd en worden de verwijderde gebruikersgegevens geretourneerd in de gegevens eigenschap van het JSON-object.

Ik heb uitgelegd wat de standaard manier is om de . te gebruiken KRIJGEN, POST, LEGGEN en VERWIJDEREN HTTP-verzoek op de API-eindpunten om CRUD-bewerkingen (Create, Read, Update and Delete) uit te voeren met behulp van REST API. Maar u kunt uw API configureren om bepaalde dingen op een bepaald HTTP-verzoek te doen. Niets is hier opgelost. U kunt de API bijvoorbeeld bijwerken met KRIJGEN HTTP-verzoek. U hoeft niet te gebruiken LEGGEN. Het is aan de API-ontwerper.

Je ontwerpt ook de API-eindpunten. Het geven van betekenisvolle namen aan uw API-eindpunten maakt uw REST API veel gemakkelijker te gebruiken.

Toepassingen van REST API:

API's maken app-ontwikkeling eenvoudiger en modulair. Met behulp van REST API kunt u uw app eenvoudig overzetten naar verschillende platforms.

Het enige wat u hoeft te doen is een REST API van uw applicatie ontwerpen en ontwikkelen. Dan kun je je REST API gebruiken vanaf je website, Android app, iOS app, Windows desktop app en Linux app etc. Op deze manier gebruiken al uw apps op verschillende platforms dezelfde logica en worden uw ontwikkeltijd en -kosten verlaagd. De apps zullen ook gemakkelijker te beheren zijn. REST API's worden tegenwoordig ook snel gebruikt in Single Page Web Applications.

Ik heb een artikel geschreven over het schrijven van REST API's met Python.  Bedankt voor het lezen van dit artikel.