![](https://help.apple.com/assets/5B296C8B680CE27831E138C3/5B296C8E680CE27831E138D3/ru_RU/c10e8a839dc838a25d0feb0e9e428a0a.png)
Выполнение первого запроса к API в Быстрых командах
Чтобы выполнить свой первый запрос к API, Вам потребуется создать URL-адрес, указывающий на «конечную точку» API, с которой Вы хотите установить связь. Затем необходимо передать этот URL-адрес действию «Получить содержимое URL». Данное действие совершает запрос к API во время выполнения быстрой команды.
![Запрос к Dark Sky API, который содержит действие «Текст» с секретным ключом API; далее отображается действие «URL-адрес», указывающее на конечную точку данного API с помощью переменной «Секретный ключ»; затем отображается действие «Получить содержимое URL».](https://help.apple.com/assets/5B296C8B680CE27831E138C3/5B296C8E680CE27831E138D3/ru_RU/d4a742722dbbd42f9d384427c726e1c7.png)
Создание запроса к API
Конечная точка Dark Sky API, которая предоставляет данные Forecast («Прогноз погоды»), требует, чтобы URL-запрос имел следующий формат:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
Текст в скобках будет замещен Вашим ключом API и данными широты и долготы геопозиции, для которой Вы хотите получить прогноз погоды.
В программе «Быстрые команды» укажите ключ Dark Sky API в первом действии «Текст», которое будет передано действию «URL-адрес» в виде переменной. В нашем примере для параметров
LAT
иLONG
уже заданы значения, соответственно,37.8267
и-122.4233
— координаты острова Алькатрас в Сан-Франциско. (Вы можете изменить эти значения по своему усмотрению.)Попробуйте использовать действие «Получить текущую геопозицию» и разместить его в качестве Волшебной переменной в поля значений Latitude (Широта) и Longitude (Долгота) действия «URL-адрес», чтобы получать данные о погоде для текущей геопозиции при каждом запуске быстрой команды.
Выполнение запроса к API с помощью действия «Получить содержимое URL»
В редакторе быстрой команды в программе «Быстрые команды» выберите параметр «Дополнительно» в действии «Получить содержимое URL».
Отобразятся следующие доступные типы запросов к API:
GET
. Этот тип запроса позволяет получить от API данные для чтения.POST
. Этот тип запроса позволяет создать новые данные.PUT
иPATCH
. Эти типы запроса позволяют обновлять данные посредством их замены или изменения, соответственно.DELETE
. Данный запрос позволяет удалить объект, указанный в URL запроса.
В этом примере используйте запрос
GET
для получения данных от Dark Sky API.Теперь, когда действие «URL-адрес» содержит Ваш запрос, а действие «Получить содержимое URL» настроено для получения данных с помощью
GET
, Вы можете выполнить запрос к API.Примечание. Когда действие «Получить содержимое URL» настроено для типов запросов
POST
,PUT
илиPATCH
, добавляется дополнительный параметр «Тело запроса». Параметр «Тело запроса» делает возможной отправку в составе Вашего запроса к API таких типов данных, как JSON, форма или файл. Это позволяет Вам вводить новые данные вручную или добавлять их с помощью переменных, чтобы затем отправлять их в запросе к API для создания, замещения или правки объекта данных.Коснитесь
, чтобы проверить функциональность быстрой команды (действие «Быстро просмотреть» позволяет отобразить в предварительном просмотре данные, которые вернул API).
Поздравляем! Вы выполнили свой первый запрос к API с помощью программы «Быстрые команды».
На первый взгляд может показаться, что API вернул большой объем текста в неудобочитаемом формате. Однако, если посмотреть внимательнее, Вы увидите, что этот текст содержит информацию о прогнозе погоды. Погодные данные кодированы в JSON; эта аббревиатура расшифровывается как JavaScript Object Notation.
Чтобы узнать о том, как работать с JSON, и продолжить рассмотрение примера Dark Sky API, см. раздел Использование JSON в программе «Быстрые команды».