![](https://help.apple.com/assets/62867F4BA154561AD42D0C98/62867F4EA154561AD42D0CA7/sv_SE/389e356d55e928d40def9c16d476e5e0.png)
Begära ditt första API i Genvägar på iPhone eller iPad
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.
![En API-förfrågan som innehåller en URL-åtgärd som pekar mot API-slutpunkten, följd av en Hämta innehåll från URL-åtgärd.](https://help.apple.com/assets/62867F4BA154561AD42D0C98/62867F4EA154561AD42D0CA7/sv_SE/90bfa2c42ce6ab074c30a85b191ce00f.png)
Bygga en 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å din iOS- eller iPadOS-enhet.
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.
Utföra API-förfrågan med hjälp av åtgärden Hämta innehåll från URL
Tryck på Visa mer i Hämta innehåll från URL-åtgärden i appen Genvägar på din iOS- eller iPadOS-enhet.
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
ellerPATCH
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.