Запит свого першого API у Швидких командах на iPhone або iPad
Щоб запитати свій перший API-інтерфейс, ви маєте створити URL-адресу, що вказує на «кінцевий пункт» API-інтерфейсу, з яким ви хочете обмінюватися даними, і потім передати цю URL-адресу до дії «Отримати вміст URL-адреси». Коли швидку команду запущено, ця дія робить API-запит.
Побудова ППІ-запиту
Кінцева точка Typicode вимагає такий формат URL-запиту:
https://jsonplaceholder.typicode.com/[РЕСУРС]
Текст у дужках — це ресурс, доступ до якого ви хочете отримати. Typicode надає різні приклади для тестування запитів. У цьому прикладі для запиту списку користувачів буде використано https://jsonplaceholder.typicode.com/users.
У програмі «Швидкі команди»
на пристрої iOS або iPadOS додайте запит до URL-адреси.Запит
usersповерне список користувачів.Ви можете уточнити пошук, зазначивши певного користувача за ідентифікатором:
https://jsonplaceholder.typicode.com/users/6. Буде повернено користувача з ідентифікатором 6.Більшість API дозволяють запити в такому форматі:
https://jsonplaceholder.typicode.com/users?username=Bret. Запит розпочинається з «?» для пошуку елементів за допомогою пар «ключ/значення». У цьому прикладі запит?username=Bretдає змогу виконати пошук користувача з іменем Bret.Підтримувані пошукові й інші запити див. в документації з API.
Здійснення ППІ-запиту за допомогою дії Отримання вмісту з URL-адреси
У програмі «Швидкі команди»
на пристрої iOS або iPadOS торкніть «Більше» в дії «Отримати вміст URL-адреси».Наведені опції для типів API-запитів, які ви можете зробити доступними:
GETдозволяє видобути дані.POSTдозволяє вам створити нові дані.PUTдозволяє оновити дані, замінивши їх.PATCHдозволяє оновити дані, змінивши їх.DELETEдозволяє вам вилучити обʼєкт, указаний в URL-запиті.
У цьому прикладі використовуйте запит
GET, щоб видобути дані з API Typicode.Тепер, коли дія URL має ваш запит, а дії «Отримати вміст URL» задано значення
GETдані, ви готові зробити API-запит.Примітка. Коли дію «Отримати вміст URL-адреси» перемкнено на
POST,PUTабоPATCH, додається новий параметр під назвою «Запитати тіло». «Запитати тіло» дає вам змогу надіслати JSON, форму або файл до API як складову свого запиту. Це дозволяє вам вводити нові дані вручну або використовуючи змінні, щоб ви могли надсилати дані до API для створення, заміни або змінення запису.Щоб протестувати швидку команду, торкніть
.
З першого погляду здається, що API-інтерфейс вертає багато незрозумілого тексту. Ці дані закодовано в JSON, що значить JavaScript Object Notation.
Щоб дізнатися про роботу з JSON і продовжити опрацювання прикладу з API Typicode, див. Вступ до використання JSON у Швидких командах на iPhone і iPad.