REST API

REST är den stil som de flesta moderna API:er är byggda i. I stället för egna kommandon använder det webbens befintliga byggstenar: en adress pekar ut vad man vill åt, och ett verb säger vad man vill göra med det.

GET    /kunder/1043      hämta kund 1043
POST   /kunder           skapa en ny kund
PUT    /kunder/1043      ersätt kund 1043
DELETE /kunder/1043      ta bort kund 1043

Svaret kommer nästan alltid som JSON. Att det bygger på webbens egna regler är hela poängen: allt som redan kan prata HTTP kan prata med ett REST API, utan särskild programvara i mitten.

Vad ni behöver veta som köpare

Ni behöver inte kunna skriva anropen. Men två saker påverkar vad en koppling kostar, och de går att fråga om.

Är det verkligen REST, eller kallas det bara så? Det förekommer API:er som skickar allt genom en enda adress och lägger kommandot i innehållet. De fungerar, men verktygsstödet är sämre och felsökningen tar längre tid.

Finns det dokumentation som går att köra mot? En OpenAPI-beskrivning (tidigare Swagger) betyder att integrationen kan börja byggas samma dag. Saknas den går de första dagarna åt till att gissa sig fram, och det syns i priset.

Det som inte är REST

SOAP är den äldre generationen och lever kvar i affärssystem och bank. Det fungerar men är tyngre. GraphQL är den nyare, där den som frågar bestämmer exakt vilka fält som ska tillbaka. Båda går att koppla mot. REST är bara det ni oftast möter.