![](https://help.apple.com/assets/5D66C362680CE25E7861EFB5/5D66C38B680CE25E7861EFC5/no_NO/c10e8a839dc838a25d0feb0e9e428a0a.png)
Forespør din første API i Snarveier
For å forespørre din første API må du opprette URL-en som peker på «API-sluttpunktet» du vil snakke med, og deretter sende URL-en til Hent innhold på URL-handlingen. Når snarveien utføres, oppretter denne handlingen API-forespørselen.
![En Dark Sky API-forespørsel som inneholder en Tekst-handling med en hemmelig API-nøkkel, etterfulgt av en URL-handling som peker på API-sluttpunktet ved hjelp av en Secret Key-variabel, etterfulgt av en Hent innhold på URL-handling.](https://help.apple.com/assets/5D66C362680CE25E7861EFB5/5D66C38B680CE25E7861EFC5/no_NO/9f49324d5bd3f88fbb7b275303d92304.png)
Bygg API-forespørselen
Dark Skys Forecast-sluttpunkt krever at en URL-forespørsel er formatert på denne måten:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
Teksten i klammer blir utfylt med en API-nøkkel og stedet du vil ha værvarseldata for.
I Snarveier-appen plasserer du API-nøkkelen fra Dark Sky i den første Tekst-handlingen, som sendes til URL-handlingen som en variabel.
LAT
ogLONG
er allerede satt til37.8267
og-122.4233
, som er koordinatene for Alcatraz-øya i San Francisco. (Du kan endre de verdiene til en annen plassering.)Prøv å bruke Hent nåværende sted-handlingen og plassere den som en magisk variabel satt til breddegrad og lengdegrad i URL-handlingen for å hente lokal værdata hver gang du utfører snarveien.
Utfør API-forespørselen med Hent innhold på URL-handlingen
Sett Hent innhold på URL til Avansert i snarveisredigereren i Snarveier-appen.
Følgende alternativer for API-forespørsler du kan opprette, blir tilgjengelig:
GET
gjør det mulig å hente data.POST
gjør det mulig å opprette nye data.PUT
gjør det mulig å oppdatere data ved å erstatte det.PATCH
gjør det mulig å oppdatere data ved å endre det.DELETE
gjør det mulig å fjerne et objekt angitt i URL-forespørselen.
I dette eksempelet bruker du en
GET
-forespørsel til å hente data fra Dark Sky-API-en.Nå som URL-handlingen har forespørselen din og Hent innhold på URL-handlingen er konfigurert til å hente (
GET
) data, er du klar til å opprette API-forespørselen.Merk: Når Hent innhold på URL-handlingen byttes til
POST
,PUT
ellerPATCH
, legges det til en ny parameter som heter Forespørselstekst. Forespørselstekst gjør det mulig å sende JSON, et Skjema eller en Fil til API-en som en del av forespørselen. Dette gjør det mulig å angi nye data manuelt eller ved hjelp av variabler, slik at du kan sende dataene til API for å opprette, erstatte eller modifisere en oppføring.Trykk på
for å teste snarveien (Hurtigvisning-handlingen i snarveien gjør det mulig å forhåndsvise dataene API-en returnerer).
Ved første øyekast ser API-en ut til å ha returnert rotete tekst. Værdataene er kodet i JSON-format, som er en forkortelse for JavaScript Object Notation.
Hvis du vil vite mer om å arbeide med JSON og fortsette å arbeide med Dark Sky API-eksempelet, leser du Introduksjon til bruk av JSON i Snarveier.