Запит свого першого ППІ у Швидких командах
Щоб запитати свій перший API-інтерфейс, ви маєте створити URL-адресу, що вказує на «кінцевий пункт» API-інтерфейсу, з яким ви хочете обмінюватися даними, і потім передати цю URL-адресу до дії «Отримати вміст URL-адреси». Коли швидку команду запущено, ця дія робить API-запит.
Побудова ППІ-запиту
Кінцева точка Прогнозу Dark Sky вимагає, щоб URL-запит мав таке форматування:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
Текст у квадратних дужках буде заповнено API-ключем і місцем, погодні дані якого ви хочете отримувати.
У програмі «Швидкі команди» помістіть свій API-ключ від Dark Sky в першу дію «Текст», що передається до дії URL як змінна. Значення
LATіLONGуже задано як37.8267і-122.4233, що є координатами острова Алькатрас у Сан-Франциско. (Ви можете замінити ці значення іншими координатами.)Спробуйте використати «Отримати поточне місце» і розмістити його як Магічну змінну, якій задано широту і довготу в дії URL, щоб отримувати місцеву погоду, де б ви не були.
Здійснення ППІ-запиту за допомогою дії Отримання вмісту з URL-адреси
У редакторі швидкої команди програми «Швидкі команди» задайте для дії «Отримати вміст за URL» значення «Додатково».
Наведені опції для типів API-запитів, які ви можете зробити доступними:
ОТРИМАТИдозволяє видобути дані.РОЗМІСТИТИдозволяє вам створити нові дані.ПОМІСТИТИдозволяє оновити дані, замінивши їх.ВИПРАВИТИдозволяє оновити дані, змінивши їх.ВИДАЛИТИдозволяє вам вилучити обʼєкт, указаний в URL-запиті.
Для цього прикладу використовуйте запит
ОТРИМАТИ, щоб видобути дані з API-інтерфейсу Dark Sky.Тепер, коли дія URL має ваш запит, а дії «Отримати вміст URL» задано значення
ОТРИМАТИдані, ви готові зробити API-запит.Примітка. Коли дію «Отримати вміст URL-адреси» перемкнено на
РОЗМІСТИТИ,ПОМІСТИТИабоЛАГОДИТИ, додається новий параметр під назвою «Запитати тіло». «Запитати тіло» дає вам змогу надіслати JSON, форму або файл до API як складову свого запиту. Це дозволяє вам вводити нові дані вручну або використовуючи змінні, щоб ви могли надсилати дані до API для створення, заміни або змінення запису.Торкніть
, щоб тестувати швидку команду (дія Швидкого перегляду у швидкій команді дозволяє вам передоглянути дані, які вертає API-інтерфейс).
З першого погляду здається, що API-інтерфейс вертає багато незрозумілого тексту. Ці погодні дані закодовано в JSON, тобто JavaScript Object Notation.
Щоб дізнатися про роботу з JSON і продовжити з прикладом API-інтерфейсу Dark Sky, див. Вступ до використання JSON у Швидких командах.