Популярные статьи
- 💰 Как проверить баланс
363 просмотра
- Как правильно набирать номер телефона?
142 просмотра
- Как прослушать голосовую почту
94 просмотра
- ☎️ Настройка и управление телефонией MCN Telecom
93 просмотра
💾POST запрос
С помощью POST-запроса можно передавать большой объём данных в теле запроса в удобном формате. Поддерживаются два типа данных:
- 📄 Text
- 🧩 JSON
💾 POST → JSON
Чтобы отправить POST-запрос с данными в формате JSON на указанный URL, выберите соответствующий тип запроса:
Настройка тела JSON-запроса
Для формирования структуры JSON доступны следующие секции:
1️⃣ Доступные параметры
Отметьте галочками параметры, которые необходимо включить в тело JSON-запроса.
- ✅ Отмеченные параметры будут переданы в запросе.
- ❌ Снятая галочка исключает параметр из запроса.
Если нажать на значок ❓, откроется описание выбранной переменной.
2️⃣ Пользовательские параметры
В данном разделе можно добавить собственные пары ключ → значение.
⚠️ Важно
| Внимание |
|---|
| В поле «Ключ» нельзя использовать переменные. Это приведёт к ошибке формирования запроса. Переменные необходимо передавать только в поле «Значение». |
3️⃣ Query-параметры
При необходимости можно передать дополнительные Query-параметры в формате:
Ключ → Значение
💡 Примечание
| Рекомендация |
|---|
| Для передачи Query-параметров рекомендуется использовать GET-запросы. |
4️⃣ Заголовки (Headers)
При необходимости добавьте HTTP-заголовки запроса.
⚠️ Важно
| Внимание |
|---|
| В поле «Ключ» нельзя использовать переменные. Это приведёт к ошибке, и веб-хук не сможет выполнить запрос. Переменные следует указывать только в поле «Значение». |
📝 Пример формирования JSON
Предположим, что были выбраны следующие параметры:
billsectimestampeventTypeInternalNumber
В результате будет сформировано следующее тело JSON-запроса:
{
"billsec": "${{billsec}}",
"timestamp": "${{timestamp}}",
"eventType": "${{eventType}}",
"InternalNumber": "${{InternalNumber}}",
"Key": "Example"
}
На указанный URL будет отправлен запрос уже с подставленными значениями:
{
"billsec": "6",
"timestamp": "1687271174",
"eventType": "VpbxInboundCallEnd",
"InternalNumber": "100",
"Key": "Example"
}
🔄 Во время выполнения веб-хука все переменные вида ${{...}} автоматически заменяются на фактические значения, полученные из события.
📄 POST → Text
Чтобы отправить POST-запрос с типом данных Text, выберите соответствующий формат:
Настройка текстового запроса
1️⃣ Доступные параметры
В данном разделе отображаются переменные, доступные для выбранного события.
Особенности работы:
-
❓ Значок вопроса показывает описание переменной.
-
🔵 Названия переменных являются интерактивными.
-
🖱️ Если установить курсор в текстовое поле и нажать на переменную, она:
- автоматически вставится в место расположения курсора;
- будет скопирована в буфер обмена.
2️⃣ Тело запроса
В разделе «Тело запроса» можно сформировать произвольную текстовую структуру данных для отправки на указанный URL.
Если необходимо использовать системные переменные, просто вставьте их из раздела «Доступные параметры».
3️⃣ Query-параметры
При необходимости можно передать дополнительные Query-параметры в формате:
Ключ → Значение
💡 Примечание
| Рекомендация |
|---|
| Для передачи Query-параметров рекомендуется использовать GET-запросы. |
4️⃣ Заголовки (Headers)
При необходимости добавьте HTTP-заголовки запроса.
⚠️ Важно
| Внимание |
|---|
| В поле «Ключ» нельзя использовать переменные. Это приведёт к ошибке, и веб-хук не сможет выполнить запрос. Переменные следует указывать только в поле «Значение». |
🔗 Дополнительные материалы
📚 Подробнее о настройке веб-хуков:
🆘 Поддержка и помощь
❓ Заявки в техническую поддержку |
📚 База знаний MCN Telecom |
☎️ +7 (495) 105-99-99 |
📧 info@mcn.ru