HTTP-запити: відмінності між версіями

Матеріал з Planfix
Перейти до: навігація, пошук
(Створена сторінка: {{#seo: |title=HTTP-запити в Planfix |titlemode=append |keywords=planfix, post-запити, POST-запити, сценарії, вхідні вебхуки, HTTP-запити, http, запити, POST, GET, PUT, DELETE, Відправка POST-запитів за допомогою автоматичних сценаріїв |description=HTTP-запити в Planfix }} Planfix працює з HTTP-запитами через Автоматичн...)
 
Немає опису редагування
 
Рядок 1: Рядок 1:
{{#seo:
{{#seo:
|title=HTTP-запити в Planfix
|title=HTTP‑запити в Planfix
|titlemode=append
|titlemode=append
|keywords=planfix, post-запити, POST-запити, сценарії, вхідні вебхуки, HTTP-запити, http, запити, POST, GET, PUT, DELETE, Відправка POST-запитів за допомогою автоматичних сценаріїв
|keywords=planfix, post‑запити, POST‑запити, сценарії, вхідні вебхуки, HTTP‑запити, http, запити, POST, GET, PUT, DELETE, Надсилання POST‑запитів за допомогою автоматичних сценаріїв
|description=HTTP-запити в Planfix
|description=HTTP‑запити в Planfix
}}
}}
Planfix працює з HTTP-запитами через [[Автоматичні сценарії|автоматичні сценарії]] та [[Вхідні вебхуки|вебхуки]], використовуючи наступні методи:
Planfix працює з HTTP‑запитами через [[Автоматичні сценарії|автоматичні сценарії]] і [[Вхідні вебхуки|вебхуки]], використовуючи наступні методи:


*GET
*GET
Рядок 13: Рядок 13:




==Приклади HTTP-запитів і розбір відповідей==
==Приклади HTTP‑запитів і розбір відповідей ==
*[[GET-запрос: получение курса валют]]
*[[POST-запит: трекінг посилок]]
*[[POST-запрос: трекинг посылок]]
*[[Вхідні вебхуки|Прийом HTTP‑запитів за допомогою вхідних вебхуків]]
*[[POST-запрос в ЮКассу: ссылка на оплату]]
<geoip eq="RU,BY">*[[GET-запрос: получение курса валют]]
*[[Вхідні вебхуки|Прийом HTTP-запитів за допомогою вхідних вебхуків]]
*[[POST-запрос в ЮКассу: ссылка на оплату]]</geoip>
 


== Важливо ==
== Важливо ==
*Відправка POST-запитів з акаунту відбувається в один потік, новий POST-запит не відправляється, поки не отримана відповідь на попередній. У зв'язку з цим, якщо віддалений сервер відповідає з істотною затримкою, може виникнути значна затримка відправки майбутніх запитів.
*Надсилання POST‑запитів з акаунта відбувається в один потік: новий POST‑запит не надсилається, поки не отримано відповідь на попередній. У зв'язку з цим, якщо віддалений сервер відповідає із суттєвою затримкою, може виникнути суттєве відставання надсилання майбутніх запитів.


*У випадку отримання від віддаленого сервера невдалої відповіді (статус відповіді не дорівнює 200), Planfix намагається повторити запит кілька разів через деякі проміжки часу (робиться ще 4 спроби повторної відправки: через 15 /+ 30 хвилин / +1 година / +1 година) - це робиться для попередження втрати повідомлень у випадку тимчасової недоступності або непрацездатності віддаленого сервера.
*У разі отримання від віддаленого сервера невдалого відповіді (статус відповіді не дорівнює 200), Planfix намагається повторити запит кілька разів із певними інтервалами (здійснюється ще 4 спроби повторної відправки: через 15 хв. / +30 хв. / +1 год. / +1 год.) — це робиться для запобігання втраті повідомлень у разі тимчасової недоступності або непрацездатності віддаленого сервера.


*При цьому протягом 3-х хвилин після отримання невдалої відповіді або відсутності відповіді з боку сервера жодні інші POST-запити з акаунту не відправляються. Це вимушений захід, який береться з метою забезпечення стабільної роботи Planfix у випадках, коли з акаунту Planfix відправляється велика кількість запитів, а сервер, куди вони відправляються, перестає відповідати.
*При цьому протягом 3 хвилин після отримання невдалого відповіді або відсутності відповіді з боку сервера ніякі інші POST‑запити з акаунта не відсилаються. Це вимушений захід, що вживається задля забезпечення стабільної роботи Planfix у випадках, коли з акаунта Planfix надсилається велика кількість запитів, а сервер, куди вони надсилаються, перестає відповідати.


*Випадки невдалої відправки фіксуються в [https://blog.planfix.ua/panel-incidentov/ Панелі інцидентів]
*Випадки невдалої відправки фіксуються в [https://planfix.com/ru/blog/panel-incidentov/ Панелі інцидентів]


*Ви можете відключити повторну відправку в налаштуванні POST-запиту:
*Ви можете відключити повторну відправку в налаштуванні POST‑запиту:


:https://p.pfx.so/pf/yc/tICMJf.png
:https://p.pfx.so/pf/yc/tICMJf.png


*У HTTP-запитах всі змінні при вставці в URL url-кодуються, тому в змінну не можна додавати URL цілком. Змінну можна використовувати в якості параметрів посилання:


<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;"><nowiki>https://</nowiki>mysite.com/?param1='''<nowiki>{{Variable_1}}</nowiki>'''&param2='''<nowiki>{{Variable_2}}</nowiki>'''</div>
*Відправлення й обробка HTTP‑запитів логуються в технічному журналі завдання:


https://p.pfx.so/pf/RD/3SkuVH.png


*Відправка і обробка HTTP-запитів логується в технічному лоґу завдання:
== Використання змінних ==
 
У HTTP‑запитах усі змінні при вставці в URL за замовчуванням URL‑кодуються (для коректної роботи при використанні в якості параметрів посилання):
https://p.pfx.so/pf/RD/3SkuVH.png


<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;"><nowiki>https://</nowiki>mysite.com/?param1='''<nowiki>{{Variable_1}}</nowiki>'''&param2='''<nowiki>{{Variable_2}}</nowiki>'''</div>
Щоб URL‑кодування не виконувалося (якщо в змінній не один параметр, а частина посилання з уже закодованими значеннями), необхідно додатково обгорнути її в %%%:
<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;">'''%%%'''<nowiki>{{Infoblock.RequestURL}}</nowiki>'''%%%'''
<nowiki>https://</nowiki>my.site.com/'''%%%'''<nowiki>{{Infoblock.Parameters}}</nowiki>'''%%%'''
</div>


== Додатково ==
== Додатково ==
*[https://blog.planfix.ua/post/ Пост про POST]
<geoip eq="RU,BY">*[https://planfix.com/ru/blog/post/ Пост про POST]
*[https://blog.planfix.ua/razbor-otvetov-na-http-zaprosy/ Розбір відповідей на HTTP-запити]
*[https://planfix.com/ru/blog/razbor-otvetov-na-http-zaprosy/ Розбір відповідей на HTTP‑запити]</geoip>
*Дані, що надходять в Planfix, перед подальшим використанням можна додатково [[Обчислити інфоблок|обробити]].
*Вхідні в Planfix дані перед подальшим використанням можна додатково [[Обчислити інфоблок|обробити]].
 


== Перейти ==
== Перейти ==
*[[Автоматичні сценарії]]
*[[Автоматичні сценарії]]
*[[Вхідні вебхуки]]
*[[Вхідні вебхуки]]
*[[API ПланФикса]]
*[https://planfix.com/help/API API]

Поточна версія на 01:28, 1 грудня 2025

Planfix працює з HTTP‑запитами через автоматичні сценарії і вебхуки, використовуючи наступні методи:

  • GET
  • POST
  • PUT
  • DELETE


Приклади HTTP‑запитів і розбір відповідей


Важливо

  • Надсилання POST‑запитів з акаунта відбувається в один потік: новий POST‑запит не надсилається, поки не отримано відповідь на попередній. У зв'язку з цим, якщо віддалений сервер відповідає із суттєвою затримкою, може виникнути суттєве відставання надсилання майбутніх запитів.
  • У разі отримання від віддаленого сервера невдалого відповіді (статус відповіді не дорівнює 200), Planfix намагається повторити запит кілька разів із певними інтервалами (здійснюється ще 4 спроби повторної відправки: через 15 хв. / +30 хв. / +1 год. / +1 год.) — це робиться для запобігання втраті повідомлень у разі тимчасової недоступності або непрацездатності віддаленого сервера.
  • При цьому протягом 3 хвилин після отримання невдалого відповіді або відсутності відповіді з боку сервера ніякі інші POST‑запити з акаунта не відсилаються. Це вимушений захід, що вживається задля забезпечення стабільної роботи Planfix у випадках, коли з акаунта Planfix надсилається велика кількість запитів, а сервер, куди вони надсилаються, перестає відповідати.
  • Ви можете відключити повторну відправку в налаштуванні POST‑запиту:
tICMJf.png


  • Відправлення й обробка HTTP‑запитів логуються в технічному журналі завдання:

3SkuVH.png

Використання змінних

У HTTP‑запитах усі змінні при вставці в URL за замовчуванням URL‑кодуються (для коректної роботи при використанні в якості параметрів посилання):

https://mysite.com/?param1={{Variable_1}}&param2={{Variable_2}}

Щоб URL‑кодування не виконувалося (якщо в змінній не один параметр, а частина посилання з уже закодованими значеннями), необхідно додатково обгорнути її в %%%:

%%%{{Infoblock.RequestURL}}%%%

https://my.site.com/%%%{{Infoblock.Parameters}}%%%

Додатково

  • Вхідні в Planfix дані перед подальшим використанням можна додатково обробити.

Перейти

Отримано з http://planfix.com/uk/help/index.php?title=HTTP-запити&oldid=4446