REST API i HTTP-protokollen
Som regel ved oprettelse af hjemmesider for at hente, oprette, ændre og slette data bruges kun metoderne GET og POST, da de understøttes godt af browsere og servere. Det samme gælder for API'er leveret af hjemmesider. Der findes dog speciale tilgange, der standardiserer API'er for generel bekvemmelighed for både API-udviklere og deres brugere.
En af tilgangene er REST API (oftest omtalt som RESTful, hvor ordet bruges som et tillægsord). Grundlaget for dette API er en bred anvendelse af metoder i HTTP-protokollen. I denne tilgang bruges GET-metoden til at hente data, POST-metoden bruges til at oprette, PUT-metoden bruges til at ændre, og DELETE-metoden bruges til at slette.
Lad os som eksempel overveje et API, der håndterer brugere. Lad os se på, hvordan URL'en vil se ud for forskellige handlinger.
Henter alle brugere:
GET http://api.loc/users/
Henter en enkelt bruger baseret på deres id:
GET http://api.loc/user/1/
Opretter en bruger:
POST http://api.loc/user/
Ændrer en bruger baseret på deres id:
PUT http://api.loc/user/1/
Sletter en bruger baseret på deres id:
DELETE http://api.loc/user/1/
Antag, at du har et API for produkter i en online butik. Beskriv butikkens URL'er på en sådan måde, at API'et bliver RESTful.