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 Hent 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 Hent 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 Hent indhold af URL-adresse
Indstil Hent 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.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 Dark Sky-API'et.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.Tryk på
for at teste genvejen (med handlingen Vis i genvejen kan du se et eksempel på de data, som API'et returnerer).
Ved første øjekast ser API'et ud til at returnere en rodet omgang tekst. Dataene i vejrudsigten er kodet i JSON, som står for JavaScript Object Notation.
Se Introduktion til brug af JSON i Genveje, hvis du vil læse om JSON og arbejde videre med eksemplet med Dark Sky-API'et.