APIviðmót

APIviðmót, eða API interface, er samspil reglna og gagnaviðmóta sem gerir forritum kleift að hafa samskipti á staðlaðan hátt. Það útskýrir hvernig kerfi hafa samskipti sín á milli, hvaða gögn eru boðin og hvernig aðgerðir eru framkvæmdar.

Helstu byggingareiningar APIviðmóts eru endpoints sem vísa til auðlinda, HTTP-aðferðir eins og GET, POST, PUT og DELETE, og gagnasnið eins og JSON eða XML. Svarið inniheldur oft staðlaðar villur og svör. Öryggi og auðkenning eru mikilvægir þættir og byggjast oft á API-lyklum, OAuth 2.0 eða JWT, auk takmörkunar á notkun og rekstraröryggi.

Arkitektúrstílar sem oft eru notaðir eru REST, SOAP, GraphQL og gRPC. REST byggir á auðlindum sem meðhöndlaðar eru með HTTP-aðferðum; SOAP notar XML-snið og formlega útfærslu; GraphQL gerir viðskiptavinum kleift að spyrja fyrir nákvæmlega þau gögn sem þarf í einni beiðni; gRPC notar binært protokoll til hraðari milliliðsamvinnu milli kerfa.

Hönnun og stjórn: Góð APIviðmót hefur skýra útgáfustefnu, góða dokumentation og leiðbeiningar fyrir þróunaraðila. Það býður upp á prófunarumhverfi (sandbox) og aðgengi að klasa- eða SDK-tólum til að auðvelda þróun.

Öryggi og rekstur: Með reglulegri viðhaldi og deprecation policy er hægt að halda samhæfni. Auk þess er mikilvægt að huga að CORS, réttindum aðgangs, inntaki og villulýsingu í svörum, og að nota útgáfu til að sporna við brottfall forrita.