REST API i HTTP-protokollen

Som regel når man lager nettsteder for å hente, opprette, endre og slette data, brukes kun GET- og POST-metodene, ettersom de støttes godt av nettlesere og servere. Det samme gjelder for API-er som tilbys av nettsteder. Det finnes imidlertid spesielle tilnærminger som standardiserer API-er for felles bekvemmelighet for både API-utviklere og deres brukere.

En av tilnærmingene er REST API (ofte kalt RESTful, og bruker dette ordet som et adjektiv). Grunnlaget for dette APIet er bred bruk av metodene i HTTP-protokollen. I denne tilnærmingen brukes GET-metoden for å hente data, POST-metoden for å opprette, PUT-metoden for å endre, og DELETE-metoden for å slette.

La oss som et eksempel se på et API som håndterer brukere. La oss se på hvordan URLene vil se ut for forskjellige handlinger.

Henter alle brukere:

urlGET http://api.loc/users/

Henter en bruker ved hans/hennes id:

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

Oppretter en bruker:

urlPOST http://api.loc/user/

Endrer en bruker ved hans/hennes id:

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

Sletter en bruker ved hans/hennes id:

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