Zero Block
Click "Block Editor" to enter the edit mode. Use layers, shapes and customize adaptability. Everything is in your hands.
Tilda Publishing
create your own block from scratch
Zero Block
Click "Block Editor" to enter the edit mode. Use layers, shapes and customize adaptability. Everything is in your hands.
Tilda Publishing
create your own block from scratch
Postman
Завантаження і початок роботи
Postman - це клієнт, який дозволяє тестувати запити API. Зручний у використанні і необхідний нам для перевірки
Скачування клієнта
Для завантаження клієнту Постмана треба перейти по посиланню.
По замовчуванню, клієнт встановлюється в директорію користувача (C:\Users\*User*\AppData\Local) і вибрати шлях неможливо, тому якщо є необхідність, можна руками перенсти в іншу папки файли клієнта.
Далі, для роботи необхідно обов’язково пройти реєстрацію, що в подальшому дозволить мати доступ до уже налаштованого середовища з будь-якого девайсу.
Можна зареєструватись/авторизуватись через пошту Google, тож з цим проблем бути не має
Імпорт налаштувань
Робота з запитами
Можна звернутись до Максима Ванденка або Євгена Єсиповича для отримання колекції уже налаштованих часто використовуваних запитів.
Тобі дадуть блокнот, що треба буде імпортувати в постман.
Перетягаємо файлик у виділене поле і колекція додана:
Повний список апі запитів є ось тут.
Тепер розглянемо приклад апі запиту на прикладі отримання токену. Натискаємо на плюсик і бачимо що у нас з’являється форма запиту
Щоб розуміти що сюди вводити, треба для початку розібратись на що треба дивитись в документації
1) Список полів в запиті та їх опис. Ті що відмічені required - ОБОВ’ЯЗКОВІ
2) Тип запиту та ендпоінт
3) Приклад тексту запиту в форматі JSON
4) Приклад відповідей з різним кодом. 200 - успіх, будь-який інший - помилка

Тепер будуємо такий запит в Постман.
Для початку, пропишемо ендпоінт та тип запиту. Робиться це ось в це поле
Тип запиту, як показано в пункті 2 - треба змінити на POST (спойлер, всі запити в апі транспорту з типом пост) ) і прописати ендпоінт, починаючи з домену публічного апі
Ось приклад готової адреси
https://api-eu.syrve.live/api/1/access_token
Якщо натиснути в інструкції на поле з пункту 2 - покажеться готове посилання на ендпоінт і його можна зкопіювати
Далі нам треба зробити тіло запиту, тобто дані з пункту 1 заповнити у форматі, як показано в пункті 3.
Для цього переключаємось на вкладку Body, змінюємо перемикач на raw і вибираємо з формату JSON і переносимо текст з пункту 3 в рядок вводу. Фінальний вигляд запиту буде ось таким
Останнє, що залишилось, це власне вказати сам апі логін. Для цього треба зайти в веб-офіс і у налаштування Syrve Live. Якщо там є логін, що нас цікавить - беремо його. Якщо немає - то створюємо новий
Тепер підставляємо це значення в Постман і робимо виклик. Як бачимо, статус виклику 200 і нижче з’явився наш токен, який ми в подальшому будемо використовувати при роботі з запитами.

На цьому поки що все, деталі роботи з постманом розглянемо в іншій статті