För att begära ditt första API skapar du den URL som pekar på den API-”ändpunkt” som du vill prata med och överför sedan denna URL till åtgärden Hämta innehåll i UR. När genvägen körs skickar denna åtgärd din API-förfrågan.
Typicode-ändpunkten kräver att en URL-begäran är formaterad så här:
https://jsonplaceholder.typicode.com/[RESURS]
Texten i hakparenteserna är resursen du vill komma åt. Typicode ger många olika exempel för att testa förfrågningar. I det här exemplet använder vi https://jsonplaceholder.typicode.com/users för att begära en lista med användare.
Lägg till förfrågan i URL:en i appen Genvägar på iPhone eller iPad.
Denna users-förfrågan returnerar en lista med användare.
Du kan begränsa sökningen genom att ange en specifik användares ID: https://jsonplaceholder.typicode.com/users/6. Detta returnerar användaren vars ID är 6.
De flesta API:er tillåter förfrågningar i följande format: https://jsonplaceholder.typicode.com/users?username=Bret. Frågetecknet ”?” påbörjar förfrågan som söker efter objekt som använder nyckel/värdepar. Sökningen ?username=Bret i det här exemplet söker efter en användare med användarnamnet Bret.
Se efter i API-dokumentationen vilka sökningar och förfrågningar som stöds.
Tryck på Visa mer i Hämta innehåll från URL-åtgärden i appen Genvägar på iPhone eller iPad.
Följande alternativ för de typer av API-förfrågningar du kan göra blir tillgängliga:
Med GET kan du hämta data.
Med POST kan du skapa nya data.
Med PUT kan du uppdatera data genom att ersätta dem.
Med PATCH kan du uppdatera data genom att ändra dem.
Med DELETE kan du ta bort ett objekt som är angivet i URL-förfrågan.
I det här exemplet använder du en GET-förfrågan till att hämta data från Typicode-API.
När URL-åtgärden har fått din begäran, och Hämta innehåll från URL-åtgärden är inställd på GET data, är du redo att göra din API-förfrågan.
Obs! När Hämta innehåll från URL ställs om till POST, PUT eller PATCH läggs en ny parameter till som heter Text i begäran. Med Text i begäran kan du skicka JSON, en blankett eller en fil till API:t som en del av din begäran. Det här gör det möjligt att skriva in nya data manuellt eller genom att använda variabler så att du kan skicka data till API:t för att skapa, ersätta eller ändra ett inlägg.
Om du vill testa genvägen trycker du på
.
Vid första anblick verkar API:t skicka tillbaka en textröra. Informationen är kodad i JSON som står för JavaScript Object Notation.
För att lära dig mer om att arbeta med JSON och fortsätta med Typicode-API-exemplet, se Introduktion till användning av JSON i Genvägar på iPhone och iPad.