Anmod om dit første API i Genveje
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 Hente indhold af URL-adresse. Når genvejen afvikles, foretager handlingen API-anmodningen.
Opbyg API-anmodningen
En URL-anmodning til Dark Skys Forecast-slutpunkt skal formateres på denne måde:
https://api.darksky.net/forecast/[DIN_HEMMELIGE_NØGLE]/[BREDDE],[LÆNGDE]
Teksten i kantede parenteser udfyldes med en API-nøgle og den lokalitet, du vil have vejrudsigten til.
Anbring i appen Genveje din API-nøgle fra Dark Sky i den første Tekst-handling, som videreføres til handlingen URL-adresse som en variabel. Værdierne til
BREDDEogLÆNGDEer allerede indstillet til37.8267og-122.4233, som er koordinaterne til øen Alcatraz i San Francisco. (Du kan ændre værdierne til en anden lokalitet).Prøv at bruge handlingen Hente aktuel lokalitet og anbringe den som en magisk variabel, der er indstillet til breddegrad og længdegrad i handlingen URL-adresse, for at få en lokal vejrudsigt, hver gang du afvikler genvejen.
Udfør API-anmodningen med handlingen Hente indhold af URL-adresse
Indstil Hente indhold af URL-adresse til Avanceret i redigeringsværktøjet til genveje i appen Genveje.
Følgende muligheder for de typer API-anmodninger, du kan foretage, bliver tilgængelige:
GETbruges til at hente data, der skal læses, fra et API.POSTbruges til at oprette nye data.PUTogPATCHbruges til at opdatere data ved henholdsvis udskifte eller æ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 Dark Sky-API'et.Nu hvor handlingen URL-adresse indeholder din anmodning, og handlingen Hente 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 Hente indhold af URL-adresse, tilføjes en ny parameter med navnet Brødtekst til anmodning. Brødtekst til 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.Tryk på
for at teste genvejen (med handlingen Vis i genvejen kan du se et eksempel på de data, som API'et returnerer).
Til lykke! Du har foretaget din første API-anmodning med Genveje.
Ved første øjekast ser API'et ud til at returnere en masse tekst med et underligt format. Hvis du ser nærmere på teksten, kan du se, at den indeholder oplysninger om vejrudsigten. Dataene i vejrudsigten er kodet i JSON, som står for JavaScript Object Notation.
Se Om brug af JSON i en genvej, hvis du vil læse om JSON og arbejde videre med eksemplet med Dark Sky-API'et.