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