Az első API kérelmezése a Parancsokban
Az első API-kérelem elküldéséhez hozza létre annak az API-nak a „végpontjára” mutató URL-t, amelyet használni szeretne, majd adja át az URL-t az URL tartalmának lekérése műveletnek. A parancs futtatásakor ez a művelet küldi el az API-kérelmet.
Az API-kérelem létrehozása
A Dark Sky’s Forecast végponthoz az URL-kérelmet a következőként kell formázni:
https://api.darksky.net/forecast/[TITKOS_KULCS]/[SZÉLESSÉG],[HOSSZÚSÁG]
A zárójelben lévő szöveg ki lesz töltve az API-kulccsal és azzal a hellyel, amelynek időjárását be szeretné olvasni.
A Parancsok alkalmazásban helyezze el a Dark Sky API-kulcsát az első Szöveg műveletben, amelyet változóként átad az URL-nek. A
LAT
ésLONG
már be van állítva a37.8267
és-122.4233
értékekre, amelyek az Alcatraz-sziget koordinátái San Franciscóban. (Ezeket az értékeket átállíthatja másik helyre.)Próbálja meg használni az Aktuális helyzet lekérése műveletet, és helyezze el Szélességre és Hosszúságra beállított Magic-változóként az URL műveletben, hogy a parancs minden futtatásakor beolvassa a helyi időjárási adatokat.
API-kérelem végrehajtása a URL tartalmának lekérése művelettel
A Parancsok alkalmazás parancsszerkesztőjében állítsa be az URL tartalmának lekérése paramétert Speciális értékre.
A következő típusú API-kérelmek lehetőségeit teheti elérhetővé:
A
GET
lehetővé teszi az adatok letöltését egy API-ból az olvasáshoz.A
POST
lehetővé teszi új adatok létrehozását.A
PUT
és aPATCH
lehetővé teszi az adatok frissítését azok lecserélésével vagy módosításával.A
DELETE
lehetővé teszi az URL-kérelemben megadott objektum törlését.
Ehhez a példához használjon egy
GET
kérelmet az adatok Dark Sky API-ból való beolvasásához.Most, hogy az URL-művelet tartalmazza a kérelmet, és az URL tartalmának lekérése művelet az adatok
GET
művelettel való beolvasására van beállítva, készen áll az API-kérelem meghívására.Megjegyzés: Amikor az URL tartalmának lekérése
POST
,PUT
vagyPATCH
értékre van átváltva, egy Szövegtörzs igénylése nevű paraméter lesz hozzáadva. A Szövegtörzs igénylése művelet lehetővé teszi, hogy a kérelem részeként JSON-t, űrlapot vagy fájlt küldjön az API-nak. Ez lehetővé teszi, hogy kézzel vagy változók használatával adjon meg új adatokat, és így adatokat küldhet az API-nak egy bejegyzés létrehozásához, lecseréléséhez vagy módosításához.Koppintson a lehetőségre a parancs teszteléséhez (a parancsban lévő Gyorsnézet művelet lehetővé teszi az API által visszaadott adatok megtekintését).
Gratulálunk, létrehozta az első API-kérelmét a Parancsokkal.
Első pillantásra úgy tűnik, hogy az API számos furcsán formázott szöveget ad vissza. Alaposabban megnézve láthatja, hogy a szöveg időjárás-előrejelzést tartalmaz. Ez az időjárási adat JSON-ban lesz kódolva, amely a JavaScript Object Notation (JavaScript-objektumelnevezés) rövidítése.
A JSON-nal végzett munkáról szóló további információk megtekintéséért és a Dark Sky API-példával való folytatáshoz tekintse meg a következőt: A JSON Parancsokban való használatáról.