![](https://help.apple.com/assets/5E8CEA35094622DF10489984/5E8CEA42094622DF1048998D/pl_PL/c10e8a839dc838a25d0feb0e9e428a0a.png)
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.
![Żądanie API Dark Sky, zawierające czynność Tekst z kluczem API, za którą znajduje się czynność URL wskazująca węzeł końcowy API z użyciem zmiennej Secret Key. Dalej umieszczona jest czynność Pobierz zawartość URL.](https://help.apple.com/assets/5E8CEA35094622DF10489984/5E8CEA42094622DF1048998D/pl_PL/f9cf16cea2f044e3ca1e3aeeff4d6d6e.png)
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
LAT
orazLONG
są ustawione na37.8267
oraz-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:
GET
pozwala na pobieranie danych.POST
pozwala na tworzenie nowych danych.PUT
pozwala na uaktualnianie danych przez ich zastępowanie.PATCH
pozwala na uaktualnianie danych przez ich modyfikowanie.DELETE
pozwala na usuwanie obiektu podanego w adresie URL żądania.
W tym przykładzie użyjemy żądania
GET
w 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
,PUT
lubPATCH
, 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.
Na pierwszy rzut oka dane zwracane przez API wyglądają jak chaotyczny tekst. 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: Wprowadzenie do używania formatu JSON w aplikacji Skróty.