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.
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.
LATogLONGer allerede satt til37.8267og-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:
GETgjør det mulig å hente data fra en API for lesing.POSTgjør det mulig å opprette nye data.PUTogPATCHgjør det mulig å oppdatere data ved å henholdsvis erstatte eller endre det.DELETEgjø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.Note: Når Hent innhold på URL-handlingen byttes til
POST,PUTellerPATCH, 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).
Gratulerer, du har opprettet din første API-forespørsel ved hjelp av Snarveier.
Ved første øyekast ser API-en ut til å ha returnert mye tekst med rar formatering. Hvis du ser nærmere, ser du at teksten inneholder værvarselinformasjon. 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 Om å bruke JSON i Snarveier.