HTTP-запити
Матеріал з Planfix
Planfix працює з HTTP-запитами через автоматичні сценарії та вебхуки, використовуючи наступні методи:
- GET
- POST
- PUT
- DELETE
Приклади HTTP-запитів і розбір відповідей
- GET-запрос: получение курса валют
- POST-запрос: трекинг посылок
- POST-запрос в ЮКассу: ссылка на оплату
- Прийом HTTP-запитів за допомогою вхідних вебхуків
Важливо
- Відправка POST-запитів з акаунту відбувається в один потік, новий POST-запит не відправляється, поки не отримана відповідь на попередній. У зв'язку з цим, якщо віддалений сервер відповідає з істотною затримкою, може виникнути значна затримка відправки майбутніх запитів.
- У випадку отримання від віддаленого сервера невдалої відповіді (статус відповіді не дорівнює 200), Planfix намагається повторити запит кілька разів через деякі проміжки часу (робиться ще 4 спроби повторної відправки: через 15 /+ 30 хвилин / +1 година / +1 година) - це робиться для попередження втрати повідомлень у випадку тимчасової недоступності або непрацездатності віддаленого сервера.
- При цьому протягом 3-х хвилин після отримання невдалої відповіді або відсутності відповіді з боку сервера жодні інші POST-запити з акаунту не відправляються. Це вимушений захід, який береться з метою забезпечення стабільної роботи Planfix у випадках, коли з акаунту Planfix відправляється велика кількість запитів, а сервер, куди вони відправляються, перестає відповідати.
- Випадки невдалої відправки фіксуються в Панелі інцидентів
- Ви можете відключити повторну відправку в налаштуванні POST-запиту:
- У HTTP-запитах всі змінні при вставці в URL url-кодуються, тому в змінну не можна додавати URL цілком. Змінну можна використовувати в якості параметрів посилання:
https://mysite.com/?param1={{Variable_1}}¶m2={{Variable_2}}
- Відправка і обробка HTTP-запитів логується в технічному лоґу завдання:
Додатково
- Пост про POST
- Розбір відповідей на HTTP-запити
- Дані, що надходять в Planfix, перед подальшим використанням можна додатково обробити.