REST API in het HTTP-protocol
Over het algemeen bij het maken van websites worden voor het ophalen, aanmaken, wijzigen en verwijderen van gegevens alleen de methodes GET en POST gebruikt, aangezien deze goed worden ondersteund door browsers en servers. Hetzelfde geldt voor API's die door websites worden aangeboden. Er bestaan echter speciale benaderingen die API's standaardiseren voor het algemene gemak van zowel de ontwikkelaars van de API, als de gebruikers ervan.
Een van deze benaderingen is REST API (men zegt vaak RESTful door dit woord als bijvoeglijk naamwoord te gebruiken). De basis van deze API ligt in het brede gebruik van de methodes van het HTTP-protocol. In deze benadering worden met de methode GET gegevens opgehaald, met de methode POST worden ze aangemaakt, met de methode PUT worden ze gewijzigd, en met de methode DELETE - worden ze verwijderd.
Laten we als voorbeeld een bepaalde API bekijken, die gebruikers manipuleert. Laten we kijken, hoe de URL's voor verschillende acties eruit zullen zien.
Alle gebruikers ophalen:
GET http://api.loc/users/
Een gebruiker ophalen op basis van zijn id:
GET http://api.loc/user/1/
Een gebruiker aanmaken:
POST http://api.loc/user/
Een gebruiker wijzigen op basis van zijn id:
PUT http://api.loc/user/1/
Een gebruiker verwijderen op basis van zijn id:
DELETE http://api.loc/user/1/
Stel dat je een API voor producten van een webwinkel hebt. Beschrijf de URL's van de winkel zo, dat de API RESTful wordt.
