Terminologi som är bra att ha koll på

Du har kanske i de tidigare kapitlena stött på ord och begrepp som du aldrig hört talas om förut eller vet inte vad det innebär. Här har vi samlat in terminologi som är bra att ha koll på när man lär sig om och använder API:er.

HTTP

Hypertext Transfer Protocol eller HTTP är ett protokoll som används för att din webbläsare ska kunna hämta innehåll från en annan dator över internet. Med hjälp av HTTP kan alltså din webbläsare kommunicera med en server och läsa in innehållet på en webbplats.

URL

När du besöker en webbplats så använder du dig av en URL. Det står för Uniform Resource Locator, och kallas även för internetadress. URL är en unik adress/sökväg till webbplats, till exempel http://www.digg.se. Många API:er har också en URL, till exempel https://api.46elks.com/a1/.

Request

När man använder ett API, eller går in på en webbplats så skickas det en request eller förfrågan till servern som API:et eller webbplatsen ligger på. Vad man frågar efter kan variera, men kan exempelvis vara om att få se innehållet på en webbplats.

Response

Efter att man har skickat en request till en webbserver så får man i sin tur ett svar tillbaka, en response. Vad det är för svar kan variera, exempelvis kan du skicka en frågan “Hej APIskolan, kan jag få se den här webbsidan?” och den response du då får är “Javisst kan du det, så här ser den här webbsidan ut”, vilket gör att du kan visa allt innehåll som du ser nu.

HTTP Statuskoder

När din webbläsare skickar en förfrågan till en webbserver så får du tillbaka ett svar, som alltid innehåller en statuskod. Detta är för att indikera hur din förfrågan har gått. Exempelvis så kan du få statuskoden “200 OK” som visar på att allt har gått bra, eller så kanske du får svaret “404 Not Found” som säger att webbplatsen inte hittades. Det finns många olika statuskoder, och här kan du läsa mer om vilka koder som finns. Läs mer om HTTP-statuskoder från Wikipedia.

HTTP Metoder

GET

När du vill till exempel be om en viss fil eller bild från internet så använder din webbläsare denna metod, vilket är det vanligaste HTTP-kommandot.

POST

Din webbläsare använder denna metod om du vill du skicka eller ladda upp en information på internet.

DELETE

Har du ångrat dig och vill ta bort den informationen som du har laddat upp så tar din webbläsare hjälp av den här metoden.

Authentication

Credentials

Vissa som tillhandahåller API:er vill ha lite bättre koll på vilka som använder deras API, av olika anledningar. Det gör att man ibland behöver skapa ett konto för att använda tjänsten. Exempelvis så skapar man ett konto hos 46elks, för att kunna använda deras API. När man väl har sitt konto hos dom får man ett användarnamn och lösenord till själva API:et. Detta är dina credentials, som du behöver för att kunna använda API:et. Det kan beskrivas som din unika identifikation, så att 46elks kan få bättre kontroll över vem som använder deras tjänst.

API Keys

Vissa använder så kallade API keys för att kontrollera användningen av API:et. Då använder man inte ett användarnamn och lösenord för att autentisera sig, utan man använder en enda nyckel.

Format (json, xml, other)

Beroende på hur ett API är uppbyggt kan deras responses eller svar se olika ut. De vanligaste formaten som data skickas med är json och xml.

JSON

Här är ett exempel på hur json-kod kan se ut:

{ key: "value", message: "Hello World!"}

XML

Här är ett exempel på hur xml-kod kan se ut:

<key>value</key>, <message>Hello World!</message>