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:

urlGET http://api.loc/users/

Henter en enkelt bruger baseret på deres id:

urlGET http://api.loc/user/1/

Opretter en bruger:

urlPOST http://api.loc/user/

Ændrer en bruger baseret på deres id:

urlPUT http://api.loc/user/1/

Sletter en bruger baseret på deres id:

urlDELETE http://api.loc/user/1/