Arkitektonisk stil til API'er - hvordan man træffer et valg

Så meget valg, når du bygger en ny API. Hvilken arkitektonisk stil skal vi vælge til vores seje nye API? Er der nogen bedste praksis med hensyn til arkitektonisk stil for API'er?

Men først, hvad er en arkitektonisk stil? Generelt er en arkitektonisk stil en storskala, foruddefineret løsningsstruktur. Der er arkitektoniske stilarter til stort set alt, f.eks. Til bygning af huse, til bygning af software og til bygning af API'er især. Brug af en arkitektonisk stil hjælper os med at designe løsningen hurtigere end at designe alt fra bunden.

Arkitektoniske stilarter leverer foruddefinerede løsningselementer og ligner således designmønstre eller designskabeloner. Mens designmønstre og skabeloner ofte bruges til at løse lokale implementeringsproblemer, såsom at iterere gennem en liste, giver arkitektoniske stilarter en løsning på en større udfordring. Beslutningen om en arkitektonisk stil er vidtrækkende og gennemsyrer den komplette løsning.

Valget af arkitektoniske stilarter bør være en af ​​de første beslutninger, når man bygger en ny API, da dette er en beslutning, der er svært at ændre senere.

  • REST API-stil (repræsentativ statsoverførsel) med HATEOAS i alle dens “niveauer” som defineret i Richardson Maturity Index.
  • GraphQL API-stil
  • RPC API-stil (Remote Procedure Call)
  • SOAP API-stil
  • gRPC API-stil
  • Falcor API-stil

API'er kan dybest set realiseres ved hjælp af en af ​​disse arkitektoniske stilarter. Hvordan ved vi, om en bestemt stil passer til et givet API? Den resulterende API afslører mange ønskelige egenskaber.

Bedste praksis med hensyn til arkitektonisk stil til API'er

Det er bedste praksis at realisere API'er ved hjælp af den REST arkitektoniske stil. Det er også den mest almindelige stil. Dette er grunden til at man i praksis kan antage, at API'er realiseres med REST-stilen. Vil du lære REST-stil til API-design? Tjek den RESTful API-designbog.

Oprindeligt udgivet på API-University.