Запит свого першого ППІ у Швидких командах
Щоб запитати свій перший 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-запитів, які ви можете зробити доступними:
ОТРИМАТИдозволяє вам отримати дані для читання з API-інтерфейсу.РОЗМІСТИТИдозволяє вам створити нові дані.ПОМІСТИТИandВИПРАВИТИдозволяє вам оновити дані, замінивши чи змінивши їх відповідно.ВИДАЛИТИдозволяє вам вилучити обʼєкт, указаний в URL-запиті.
Для цього прикладу використовуйте запит
ОТРИМАТИ, щоб видобути дані з API-інтерфейсу Dark Sky.Тепер, коли дія URL має ваш запит, а дії «Отримати вміст URL» задано значення
ОТРИМАТИдані, ви готові зробити API-запит.Примітка. Коли дію «Отримати вміст URL-адреси» перемкнено на
РОЗМІСТИТИ,ПОМІСТИТИабоЛАГОДИТИ, додається новий параметр під назвою «Запитати тіло». «Запитати тіло» дає вам змогу надіслати JSON, форму або файл до API як складову свого запиту. Це дозволяє вам вводити нові дані вручну або використовуючи змінні, щоб ви могли надсилати дані до API для створення, заміни або змінення запису.Торкніть
, щоб тестувати швидку команду (дія Швидкого перегляду у швидкій команді дозволяє вам передоглянути дані, які вертає API-інтерфейс).
Щиро вітаємо, ви зробили перший запит API-інтерфейсу за допомогою Швидких команд.
З першого погляду видається, що API-інтерфейс вертає багато дивно форматованого тексту. Розглянувши ближче, ви може бачити, що цей текст містить метеорологічну інформацію. Ці погодні дані закодовано в JSON, тобто JavaScript Object Notation.
Щоб дізнатися про роботу з JSON і продовжити з прикладом API-інтерфейсу Dark Sky, див. Про використання JSON у Швидких командах.