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:
GET http://api.loc/users/
Henter en bruker ved hans/hennes id:
GET http://api.loc/user/1/
Oppretter en bruker:
POST http://api.loc/user/
Endrer en bruker ved hans/hennes id:
PUT http://api.loc/user/1/
Sletter en bruker ved hans/hennes id:
DELETE http://api.loc/user/1/
Anta at du har et API for produkter i en nettbutikk. Beskriv butikkens URLer på en slik måte at APIet blir RESTful.
