APIpäringud

API päringud ehk API taotlused on kliendi ja serveri vahelised päringud, mille eesmärk on saada andmeid või käivitada toiminguid API kaudu. Need päringud tavaliselt kasutavad HTTP-protokolli ning võivad põhineda REST- või GraphQL-mudelile.

Päring koosneb ressursi URL-ist, HTTP meetodist, päisestest (headers) ning vajadusel päringu- või keha (body). Kehas kasutatakse sageli JSON'i. Olulised päised hõlmavad Content-Type ja Accept, mis määravad andmete vormingut ja vastuvõtu ootusi.

Levinumad meetodid on GET (andmete pärimine), POST (uue ressursi loomine või toimingu algatamine), PUT (ressursi täielik uuendamine/asendamine), PATCH (osaline uuendus) ja DELETE (kustutamine). REST-põhistes API-des on need meetodid peamised; GraphQL kasutab erinevat lähenemist ühe lõpppunkiga.

Vastus sisaldab tavaliselt HTTP-staatuskoodi ja vastuseandmeid. Levinud koodid: 200 OK, 201 Created, 204 No Content, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error. Vastuse sisu on sageli JSON.

Turvalisus ja autentimine: API päringud peaksid toimuma HTTPS-i kaudu. Autentimine toimub näiteks API-võtmete (API keys), OAuth 2.0 tokenite või JSON Web Tokenite (JWT) abil. Autoriseerimine kontrollib, milliseid ressursse kasutaja või rakendus saata võib.

Juurdepääsu kontroll ja jõudluse haldamine: Põhilised meetmed on rate limiting (põimunud piirangud) ja backoff-strateegiad. Paginatsioon aitab suurte kogumite puhul vähendada vastuse mahtu; levinud strateegiad on page/limit ja cursor-based paginatsioon. Teenused võivad ka vahemällu salvestada (caching) vastuseid.

Dokumentatsioon, testimine ja tööriistad: API päringute arendamisel kasutatakse curl, Postman või Insomnia. Dokumentatsioon sisaldab sageli OpenAPI/Swagger-deskriptsioone. Versioonimine tagab stabiilse ühilduvuse ja selguse ajaliste muudatuste kohta.