Erstkontakt zur API in der App „Kurzbefehle“
Für den Erstkontakt zur API musst du die URL zum „Endpunkt“ der API aufbauen, mit der du kommunizieren möchtest, und diese URL an die Aktion „Inhalte von URL abrufen“ übergeben. Beim Ausführen des Kurzbefehls generiert diese Aktion die API-Anforderung.
Erstellen von API-Anforderung
Für die Kommunikation mit dem Endpunkt „Forecast“ von Dark Sky muss die URL-Anforderung wie folgt formatiert werden:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
Der Text in eckigen Klammern wird mit einem API-Schlüssel und dem Namen des Orts ausgefüllt, für den die Vorhersagedaten gewünscht werden.
Platziere in der App „Kurzbefehle“ den API-Schlüssel, den du von Dark Sky erhalten hast, in der ersten Aktion „Text“, die als Variable an die Aktion „URL“ übergeben wird. Die Parameter „
LAT“ und „LONG“ sind bereits auf die Werte „37.8267“ und „-122.4233“ eingestellt. Dies sind die Koordinaten der Insel Alcatraz in der Bucht von San Francisco. (Du kannst diese Koordinaten aber durch Koordinaten deiner Wahl ersetzen.)Du kannst nun die Aktion „Aktuellen Ort abrufen“ verwenden und als magische Variable platzieren, um die geografische Breite und Länge in der Aktion „URL“ zu definieren, sodass du beim Ausführen des Kurzbefehls immer die Wetterdaten des Orts erhältst, an dem du dich gerade befindest.
API-Anforderung mit der Aktion „Inhalte von URL abrufen“ ausführen
Setze im Kurzbefehleditor der App „Kurzbefehle“ die Aktion „Inhalte von URL abrufen“ auf „Fortgeschritten“.
Daraufhin werden die folgenden Optionen für die Typen von API-Anforderungen angezeigt, die du senden kannst:
GET: Mit dieser Anforderung du Daten abrufen.POST: Mit dieser Anforderung kannst du neue Daten erstellen.PUT: Mit dieser Anforderung kannst du Daten durch Ersetzen aktualisieren.PATCH: Mit dieser Anforderung kannst du Daten durch Ändern aktualisieren.DELETE: Mit dieser Anforderung kannst du das in der URL-Anforderung angegebene Objekt löschen.
In diesem Beispiel wird die Anforderung
GETverwendet, um Daten von der API von Dark Sky abzurufen.Nachdem die Aktion „URL“ deine Anforderung hat und die Aktion „Inhalte von URL abrufen“ für
GET, d. h. für das Abrufen von Daten konfiguriert wurde, kannst du deine API-Anforderung senden.Hinweis: Wenn du die Aktion „Inhalte von URL abrufen“ für
POST,PUToderPATCHkonfigurierst, wird ein weiterer Parameter „Haupttext anfordern“ hinzugefügt. Mithilfe des Parameters „Haupttext anfordern“ kannst du JSON-Daten, ein Formular oder eine Datei als Bestandteil deiner Anforderung an die API senden. Dies bietet dir die Möglichkeit, Daten manuell oder mithilfe von Variablen einzugeben, sodass du Daten an die API senden kannst, mit denen ein Eintrag erstellt, ersetzt oder modifiziert werden soll.Tippe auf
, um den Kurzbefehl zu testen. (Die in den Kurzbefehl eingebettete Aktion „Übersicht“ ermöglicht es dir, die von der API als Antwort gesendeten Daten in der Vorschau zu prüfen.)
Auf den ersten Blick scheint die Antwort der API aus unverständlichem Text zu bestehen. Diese Wetterinformationen sind in JSON (Akronym für JavaScript Object Notation) codiert.
Weitere Informationen über die Verwendung von JSON und die Fortsetzung des Kurzbefehls am Beispiel der API von Dark Sky findest du unter Einführung in die Verwendung von JSON in der App „Kurzbefehle“.