Wysyłanie pierwszego żądania API w aplikacji Skróty
Aby wysłać żądanie API, musisz utworzyć URL wskazujący „węzeł końcowy” API, a następnie przekazać ten URL do czynności Pobierz zawartość URL. Po uruchomieniu skrótu czynność ta wysyła żądanie API.
Tworzenie żądania API
Węzeł końcowy prognozy pogody Dark Sky wymaga użycia adresu URL z żądaniem sformatowanego w następujący sposób:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
Tekst w nawiasach kwadratowych zostanie zastąpiony kluczem API oraz współrzędnymi miejsca, dla którego chcesz uzyskać dane dotyczące prognozy pogody.
Umieść swój klucz API z Dark Sky w pierwszej czynności Tekst (w aplikacji Skróty). Zostanie on przekazany jako zmienna do czynności URL. Wartości
LATorazLONGsą ustawione na37.8267oraz-122.4233, czyli współrzędne wyspy Alcatraz w San Francisco. Możesz zmienić je na współrzędne geograficzne dowolnego innego miejsca.Spróbuj użyć czynności Pobierz bieżące położenie i umieścić zwracane przez nią dane w adresie w czynności URL jako Magiczną zmienną skonfigurowaną do pobierania szerokości i długości geograficznej, aby uruchomiony skrót uzyskiwał lokalne dane pogodowe.
Wysyłanie żądania API przy użyciu czynności Pobierz zawartość URL
Przełącz tryb czynności Pobierz zawartość URL (widocznej w edytorze skrótów w aplikacji Skróty) na Zaawansowane.
Pojawią się następujące opcje dotyczące możliwych typów żądania API:
GETpozwala na pobieranie danych z API w celu ich odczytania.POSTpozwala na tworzenie nowych danych.PUTorazPATCHpozwalają na uaktualnianie danych, odpowiednio przez ich zastępowanie lub modyfikowanie.DELETEpozwala na usuwanie obiektu podanego w adresie URL żądania.
W tym przykładzie użyjemy żądania
GETw celu pobrania danych przy użyciu API serwisu Dark Sky.Gdy czynność URL zawiera żądanie, a czynność Pobierz zawartość URL jest skonfigurowana do pobrania danych przy użyciu metody
GET, wszystko jest gotowe do wysłania żądania API.Uwaga: Gdy metoda czynności Pobierz zawartość URL zostanie przełączona na
POST,PUTlubPATCH, pojawi się nowy parametr o nazwie Żądanie treści. Pozwala on na wysłanie do API (jako części żądania) danych w formacie JSON, formularza lub pliku. Pozwala to na wprowadzanie nowych danych ręcznie lub przy użyciu zmiennych, umożliwiając wysyłanie danych do API w celu tworzenia, zastępowania lub zmieniania danego wpisu.Stuknij w
, aby przetestować skrót. Czynność Szybki przegląd pozwala na wyświetlenie danych zwracanych przez API.
Gratulujemy! To Twoje pierwsze żądanie API wykonane przy użyciu aplikacji Skróty.
Na pierwszy rzut oka dane zwracane przez API wyglądają jak duża ilość dziwnie sformatowanego tekstu. Po dokładniejszym przyjrzeniu się otrzymanym danym można zauważyć, że zawierają one prognozę pogody. Te dane pogodowe są zakodowane w formacie JSON, czyli JavaScript Object Notation.
Aby dowiedzieć się więcej o pracy z danymi w formacie JSON oraz kontynuować przykład API Dark Sky, zobacz: Używanie danych w formacie JSON w aplikacji Skróty.