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ésLONGmá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
GETlehetővé teszi adatok lekérését.A
POSTlehetővé teszi új adatok létrehozását.A
PUTlehetővé teszi adatok frissítését lecserélésükkel.A
PATCHfuttatásával adatokat frissíthet azok módosításával.A
DELETElehetővé teszi az URL-kérelemben megadott objektum törlését.
Ehhez a példához használjon egy
GETké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
GETmű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,PUTvagyPATCHé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 manuálisan 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).
Első pillantásra úgy tűnik, hogy az API furcsa szöveget ad vissza. 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ának bemutatása.