APIvastaus
APIvastaus tarkoittaa sovellusrajapinnan (API) palauttamamaa vastausta asiakkaan tekemälle pyynnölle. Sen tarkoituksena on kertoa, onnistuiko pyyntö ja tarjota mahdollisesti pyydetty data tai virhetilanteen tiedot. APIvastaus muodostuu useimmiten HTTP-vastauksesta, jossa on tilakoodi, otsikot ja runko (body).
Tilakoodi kuvaa pyynnön lopputulosta; yleisesti käytettyjä luokkia ovat 2xx menestys, 4xx asiakasvirhe ja 5xx palvelinvirhe. Otsikot
Runko on usein JSON-muodossa, mutta XML, YAML tai muut muodot ovat mahdollisia riippuen API:n sopimuksesta. Virhetilanteissa
Hyviä käytäntöjä ovat oikea semanttinen rakenne, virheiden yhdenmukainen käsittely sekä tuki versioningille ja ominaisuuksien, kuten sivutuksen,
Esimerkki: HTTP/1.1 200 OK; Content-Type: application/json; Body: {"id":123,"name":"Widget"}