![](https://help.apple.com/assets/5B296C8B680CE27831E138C3/5B296C8E680CE27831E138D3/de_DE/c10e8a839dc838a25d0feb0e9e428a0a.png)
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.
![Eine Anforderung an die API von Dark Sky mit der Aktion „Text", bestehend aus (in dieser Reihenfolge) dem geheimen Schlüssel für die API, der Aktion „URL“ mit dem Verweis auf den Endpunkt der API unter Verwendung der Variablen „Secret Key" und der Aktion „Inhalte von URL abrufen“.](https://help.apple.com/assets/5B296C8B680CE27831E138C3/5B296C8E680CE27831E138D3/de_DE/d4a742722dbbd42f9d384427c726e1c7.png)
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 kannst du Daten von einer API zum Lesen anfordern.POST
: Mit dieser Anforderung kannst du neue Daten erstellen.PUT
undPATCH
: Mit diesen Anforderungen kannst du Daten aktualisieren, indem du sie ersetzt bzw. modifizierst.DELETE
: Mit dieser Anforderung kannst du das in der URL-Anforderung angegebene Objekt löschen.
In diesem Beispiel wird die Anforderung
GET
verwendet, 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
,PUT
oderPATCH
konfigurierst, 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.)
Herzlichen Glückwunsch! Du hast damit deine erste API-Anforderung mithilfe der App „Kurzbefehle“ erstellt und gesendet.
Auf den ersten Blick scheint die Antwort der API aus sehr viel merkwürdig formatiertem Text zu bestehen. Bei näherer Betrachtung wirst du aber erkennen, dass es sich bei diesem Text um Informationen der Wettervorhersage handelt. 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 Verwenden von JSON in der App „Kurzbefehle“.