Introduktion til API'er

Webtjenester er en måde, hvorpå softwareapplikationer kan kommunikere med hinanden på internettet. Dette muliggør kommunikation mellem softwaresystemer, der er bygget ved hjælp af forskellige platforme og programmeringssprog. For eksempel kan en app skrevet i C#, der kører på vores computer, kommunikere med et websted ved hjælp af webtjenester.

Der findes flere typer webtjenester, og det er et bredt emne, men vi vil fokusere på API'er, da de er den mest almindelige type webtjenester. Desuden er API'er relevante at lære om på dette niveau.

En API, også kendt som et Application Programming Interface, er et interface for en klient til at kommunikere med en server.

En klient er typisk en ekstern applikation. Normalt definerer vi en klient som en bruger. Mere specifikt er en klient dog en applikation, for eksempel en webbrowser eller en konsolapplikation. En klient kan også være en del af en større applikation, der er bygget i mange dele eller programmeringssprog.

En server er en computer, der hoster applikationen, hvilket kan være et websted, et databasesystem eller noget andet.

I praksis sender en klient en besked til en server gennem en webanmodning, og serveren behandler anmodningen og sender et svar. Vi lærer, hvordan man sender webanmodninger i næste kapitel.

Den webanmodning, vi sender til serveren, er mere specifikt en HTTP-anmodning. HTTP er en protokol til datakommunikation mellem en klient og en server. En HTTP-anmodning er en besked, der går fra klienten til serveren ved hjælp af HTTP-protokollen. Vi behøver ikke forstå, hvordan HTTP-protokollen fungerer. Vi skal dog vide, hvilke typer HTTP-anmodninger der findes. De fire mest almindelige typer HTTP-anmodninger er:

• GET: Hent data fra serveren. Bruges til at hente information og bør ikke have nogen bivirkninger på serveren;

• POST: Indsend data til serveren for at oprette en ny ressource. Involverer ofte opdatering af en database eller behandling af formularoplysninger;

• PUT: Opdater en ressource på serveren. Bruges til enten at oprette en ny ressource eller erstatte en eksisterende fuldstændigt;

• DELETE: Anmod om fjernelse af en ressource på serveren. Bruges til at slette den angivne ressource.

Når en klient sender en HTTP-anmodning til en server, angiver klienten også HTTP-metoden i den. HTTP-metoden er blot typen af anmodning, dvs. GET, POST, PUT, DELETE osv. Det hjælper den modtagende server med at behandle anmodningen korrekt.

Meget af behandlingen foregår på API-delen, for eksempel validering og/eller dekodning af beskeden fra klienten.