![](https://help.apple.com/assets/5D38A6ED0946225A2D640948/5D38A6F70946225A2D640958/ru_RU/c10e8a839dc838a25d0feb0e9e428a0a.png)
Выполнение первого запроса к API в Быстрых командах
Чтобы выполнить свой первый запрос к API, Вам потребуется создать URL-адрес, указывающий на «конечную точку» API, с которой Вы хотите установить связь. Затем необходимо передать этот URL-адрес действию «Получить содержимое URL». Данное действие совершает запрос к API во время выполнения быстрой команды.
![Запрос к Dark Sky API, который содержит действие «Текст» с секретным ключом API; далее отображается действие «URL-адрес», указывающее на конечную точку данного API с помощью переменной «Секретный ключ»; затем отображается действие «Получить содержимое URL».](https://help.apple.com/assets/5D38A6ED0946225A2D640948/5D38A6F70946225A2D640958/ru_RU/22dae7009daf6596aa92f6fc5b287037.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
позволяет получать данные.POST
. Этот тип запроса позволяет создать новые данные.Запрос
PUT
позволяет обновлять данные посредством их замены.Запрос
PATCH
позволяет обновлять данные посредством их изменения.DELETE
. Данный запрос позволяет удалить объект, указанный в URL запроса.
В этом примере используйте запрос
GET
для получения данных от Dark Sky API.Теперь, когда действие «URL-адрес» содержит Ваш запрос, а действие «Получить содержимое URL» настроено для получения данных с помощью
GET
, Вы можете выполнить запрос к API.Примечание. Когда действие «Получить содержимое URL» настроено для типов запросов
POST
,PUT
илиPATCH
, добавляется дополнительный параметр «Тело запроса». Параметр «Тело запроса» делает возможной отправку в составе Вашего запроса к API таких типов данных, как JSON, форма или файл. Это позволяет Вам вводить новые данные вручную или добавлять их с помощью переменных, чтобы затем отправлять их в запросе к API для создания, замещения или правки объекта данных.Коснитесь
, чтобы проверить функциональность быстрой команды (действие «Быстро просмотреть» позволяет отобразить в предварительном просмотре данные, которые вернул API).
На первый взгляд может показаться, что API вернул нечитаемый текст. Погодные данные кодированы в JSON; эта аббревиатура расшифровывается как JavaScript Object Notation.
Чтобы узнать о том, как работать с JSON, и продолжить рассмотрение примера Dark Sky API, см. раздел Использование JSON в приложении «Быстрые команды».