Redigerer Programmeringsgrensesnitt (avsnitt)

== REST-API ==
{{hoved|Representational state transfer}}
REST står for [[Representational state transfer|REpresentational State Transfer]]. Når et REST-API kalles, vil serveren overføre en representasjon av tilstanden til den etterspurte ressursen. Denne representasjonen kan være skrevet i [[JSON]], [[XML]] eller [[HTML]] format.

En REST webapplikasjon eksponerer informasjon om tjenestene til klienter. Klientene kan utføre oppgaver basert på denne informasjonen.

For at et API skal være et REST-API må det følges et sett med begrensninger når det skrives. Disse begrensningene vil gjøre det enklere for utviklere som har mindre erfaring med API-kall.<ref>{{Kilde www|url=https://medium.com/extend/what-is-rest-a-simple-explanation-for-beginners-part-2-rest-constraints-129a4b69a582|tittel=What is REST — A Simple Explanation for Beginners, Part 2: REST Constraints|besøksdato=12.11.2019|forfattere=Shif Ben Avraham|dato=05.09.2019|forlag=|sitat=}}</ref>

=== CRUD-stil ===
Handlingene «[[opprett, les, oppdater og slett]]» (engelsk: ''create, read, update and delete'', CRUD) er fire grunnleggende operasjoner når det gjelder lagring av data. CRUD-begrepet brukes generelt innen IT for å beskrive en konvensjon for brukergrensesnitt som skal gjøre det enklere å finne, lese og endre informasjon. CRUD-stilen er også en vanlig stil å benytte for utforming av REST API-er, og forstås da å bety følgende [[HTTP]]-metoder:

{| class="wikitable"
|-
! CRUD
! HTTP
|-
| Create
| [[Hypertext Transfer Protocol#Request methods|PUT]] <!-- Do not replace with POST which is not a CRUD operation (cf. below). -->
|- <!-- POST should be added.
POST is a CRUD operation in the same way as SQL INSERT. 
If the key is specified in INSERT, then the equivalent REST is indeed PUT. 
On the other hand, if a table autogenerates the key and the INSERT doesn't have the key, then the equivalent REST is POST.

"that doesn’t mean we can live without it. POST serves many useful purposes in HTTP." It is the standard way of creating a new object where the server assigns the id. We can't help that in all other ways, POST is as loosy goosy as Roy said.

The user agent doesn't always have the onus of knowing the key/id when creating in web or relational databases. Knowing the key when creating is NOT a requirement of CRUD, SQL, or REST. -->
| Read
| [[Hypertext Transfer Protocol#Request methods|GET]]
|-
| Update
| [[Hypertext Transfer Protocol#Request methods|PUT]]
|- <!-- PATCH should be added. In the same way where SQL UPDATE can replace all or part of a row. 
 PUT replaces the entire entity. PATCH replaces part of the entity. 
On the other hand, if a table autogenerates the key and the INSERT doesn't have the key, then the equivalent REST is POST. -->
| Delete
| [[Hypertext Transfer Protocol#Request methods|DELETE]]
|}

I HTTP er metodene GET (les), PUT (opprett og oppdater) og DELETE (slett) CRUD-operasjoner ettersom de har [[semantikk]] for lagringsadministrasjon, hvilket betyr at de lar brukeragenter direkte manipulere tilstandene til [[vevressurs|målressurser]].<ref>{{cite web |url=https://tools.ietf.org/html/rfc7231#section-4 |title=Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content, Section 4 |last=Fielding |first=Roy |date=juni 2014 |website=IETF |publisher=Internet Engineering Task Force (IETF) |access-date=2018-02-14 |rfc=7231}}</ref> POST-metoden er derimot en prosessoperasjon som har målressursspesifikk semantikk som typisk går utenfor omfanget av CRUD-operasjoner.<ref name="it-is-okay-to-use-post">{{cite web|url=https://roy.gbiv.com/untangled/2009/it-is-okay-to-use-post |title=It is okay to use POST |author=Roy T. Fielding |publisher=roy.gbiv.com |date=2009-03-20 |access-date=2020-04-14 |quote=POST only becomes an issue when it is used in a situation for which some other method is ideally suited: e.g., retrieval of information that should be a representation of some resource (GET), complete replacement of a representation (PUT), or any of the other standardized methods that tell intermediaries something more valuable than “this may change something.” The other methods are more valuable to intermediaries because they say something about how failures can be automatically handled and how intermediate caches can optimize their behavior. POST does not have those characteristics, but that doesn’t mean we can live without it. POST serves many useful purposes in HTTP, including the general purpose of “this action isn’t worth standardizing.”}}</ref>

En annen stil som også er brukt en del kalles ''Hypermedia as the Engine of Application State'' (HATEOAS).