Nu ska vi testa att anropa ett riktigt API! Vi använder oss av Postman för att kommunicera med 46elks API. Med hjälp av 46elks API ska du nu skicka ett SMS till dig själv. Du har kanske fått en påminnelse om tandläkartid förut? Det är genom att använda ett API som man kan automatisera ett sånt SMS.
För att kunna använda 46elks API behöver vi en URL(adress).
1. Skriv URL:en https://api.46elks.com/a1/ i rutan där det står “Enter request URL”.
2. Klicka sedan på “Send”.
Du fick förmodligen ett svar som säger “API access requires Basic HTTP authentication. Read documentation or examples.”
Detta innebär att du måste autentisera dig. Du behöver alltså en nyckel för att komma åt API:et.
💡 För att kunna autentisera dig behöver du skapa ett konto hos 46elks. När du skapar ett konto får du ett API användarnamn och lösenord som du kan använda för att autentisera dig, dessa kallas också ibland för “API-keys”.
3. Skapa ett konto hos 46elks för att få ett användarnamn och lösenord till API:et. Du behöver ha din telefon nära till hands då du kommer att få ett telefonsamtal för att bekräfta att du är en människa och inte robot.
Nu när du har skapat ditt konto och loggat in hos 46elks så kan du i deras webbplats hitta ditt API användarnamn (username) och lösenord (password) under “API Credentials”.
4. Gå tillbaka till Postman för att autentisera dig. Det gör du under “Authorization” eller "Auth" där du ändrar vad som står i type-rutan till “Basic Auth”.
5. Fyll i sedan ditt API användarnamn och lösenord och klicka på den blåa knappen “Send”.
Nu är du inne!
6. I Postman, testa att lägga till me i slutet av URL:en. Så här kommer URL:en att se ut efter du har gjort det: https://api.46elks.com/a1/me Klicka sedan på “Send”. Vad får du för svar?
Nu ska du få testa att skicka SMS till dig själv med hjälp av 46elks API.
1. Ändra anropet från GET till POST i Postman.
💡 POST är precis som GET också en metod, men det används när du vill skicka med data.
2. Lägg till sms i slutet av din url. URL:en borde nu se ut såhär: https://api.46elks.com/a1/sms.
3. Klicka på “Body” och ändra formatet till "x-www-form-urlencoded". Det är den formatet som 46elks använder för att skicka med data till sitt API, men det finns olika sätt.
4. Fyll i “key” och “value” med information om avsändare, mottagare och meddelandet som ska skickas. “Key” innebär vad för slags information är det som läggs i value. “Value” är då informationen som man vill hämta eller skicka.
I exemplet på bilden nedan har vi fyllt i “key” med to, from och message, “value” har fyllts i med apiskolan som avsändare (from), +46712345678 som mottagare (to), och "jag använder ett api för att skicka sms" som meddelande (message).
5. Klicka på “Send”. Nu har du kommunicerat med ett riktigt API! I nästa kapitel får du se exempel på hur koden kan se ut när man anropar ett API.