Anmod om dit første API i Genveje på iPhone eller iPad
Du anmoder om dit første API ved at oprette den URL-adresse, der henviser til det “slutpunkt” i API'et, du vil kommunikere med, og viderefører derefter denne URL-adresse til handlingen Hent indhold af URL-adresse. Når genvejen afvikles, foretager handlingen API-anmodningen.
Opbyg API-anmodningen
En URL-anmodning til Typicode-slutpunktet skal formateres på denne måde:
https://jsonplaceholder.typicode.com/[RESSOURCE]
Teksten mellem klammerne er den ressource, du vil have adgang til. Typicode leverer mange forskellige eksempler til testanmodninger. Dette eksempel bruger https://jsonplaceholder.typicode.com/users til at anmode om en liste med brugere.
Føj anmodningen til URL-adressen i appen Genveje
på din iOS- eller iPadOS-enhed.Anmodningen om
brugerevil generere en liste med brugere.Du kan indsnævre din søgning ved at specificere en bestemt bruger ud fra id’et:
https://jsonplaceholder.typicode.com/users/6. Denne URL vil generere den bruger, hvis id er 6.De fleste API’er tillader anmodninger, der bruger følgende format:
https://jsonplaceholder.typicode.com/users?username=Bret. Spørgsmålstegnet udgør starten af anmodningen, som søger efter emner vha. nøgle-værdipar. I dette eksempel søger anmodningen?username=Bretefter en bruger, hvis brugernavn er Bret.Læs mere om understøttede søgninger og anmodninger i dokumentationen til din API.
Udfør API-anmodningen med handlingen Hent indhold af URL-adresse
Tryk på Vis mere i handlingen Hent indhold af URL-adresse i appen Genveje
på din iOS- eller iPadOS-enhed.Følgende muligheder for de typer API-anmodninger, du kan foretage, bliver tilgængelige:
GETbruges til at hente data.POSTbruges til at oprette nye data.PUTbruges til at opdatere data ved at udskifte dem.PATCHbruges til at opdatere data ved at ændre dem.DELETEbruges til at fjerne et objekt, der er anført i URL-anmodningen.
I dette eksempel bruger vi en
GET-anmodning til at hente data fra Typicode API'en.Nu hvor handlingen URL-adresse indeholder din anmodning, og handlingen Hent indhold af URL-adresse er indstillet til at hente (
GET) data, er du klar til at foretage API-anmodningen.Bemærk: Hvis du skifter til
POST,PUTellerPATCHi handlingen Hent indhold af URL-adresse, tilføjes en ny parameter med navnet Indhold af anmodning. Indhold af anmodning giver dig mulighed for at sende JSON, en formular eller et arkiv med i din anmodning til API'et. Det betyder, at du kan indsætte nye data manuelt eller ved at bruge variabler og sende data til API'et for at oprette, udskifte eller ændre en optegnelse.Du tester genvejen ved at trykke på
.
Ved første øjekast ser API'et ud til at returnere en rodet omgang tekst. Disse data er kodet i JSON, som står for JavaScript Object Notation.
Se Introduktion til brug af JSON i Genveje på iPhone og iPad, hvis du vil læse mere om at arbejde med JSON og fortsætte med Typicode API-eksemplet.