Выполнение первого запроса к API в Быстрых командах
Чтобы выполнить свой первый запрос к API, Вам потребуется создать URL-адрес, указывающий на «конечную точку» API, с которой Вы хотите установить связь. Затем необходимо передать этот URL-адрес действию «Получить содержимое URL». Данное действие совершает запрос к API во время выполнения быстрой команды.
Создание запроса к 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 в программе «Быстрые команды».