Процесс настройки:
- Откройте окно настройки запроса (как описано в начале раздела).
- Укажите URL запроса и метод.
- При необходимости, укажите HTTP заголовки и передаваемые данные в формате JSON.
- Сохраните запрос.
Метод запроса
По умолчанию, доступны GET и POST запросы, однако, если Вам требуются другие методы, напишите мне widget.bot-manager.com/botmanager, и мы добавим их для Вас.
HTTP заголовки
Если требуется, Вы можете указать заголовки, каждый с новой строки в формате <Название заголовка>:<Значение>
Для POST запросов автоматически устанавливается заголовок «Content-Type» со значением «application/json». Вы можете его переопределить, одна не гарантируем, что тело запроса дойдет на адресата.
Можете использовать настраиваемые запросы или спец поля для получения динамических данных, однако следите, чтобы эти поля возвращали значение (одна строка с одним столбцом), а не таблицу значений, иначе запрос выполнится с неожиданными заголовками.
Query-параметры (в URL)
Для передачи query-параметров, укажите их в URL запроса в общепринятом формате ключ=значение, разделенные символов «&», после символа «?».
Можете использовать настраиваемые запросы или спец поля для получения динамических данных, однако следите, чтобы эти поля возвращали значение (одна строка с одним столбцом), а не таблицу значений, иначе передаваемые данные будут искажены.
Тело запроса (JSON)
Тело POST запроса будет отправлено именно в том виде, как укажете Вы (включая символы переносов строк)
Можете использовать спец поля и настраиваемые запросы для получения динамических данных, однако для последних есть нюансы:
- Если использовать запрос данных из БД, возвращающий одну строку с одним столбцом (то есть одно значение), то оно вставится как есть. Таким образом Вы должны позаботиться, должно ли поле быть в кавычках или нет (на скриншоте выше значение param3 обернуто в кавычки).
- Если использовать запрос данных из БД, возвращающий одну строку с несколькими столбцами (строка значений) или много строк с один столбцом (столбец значений), то все значения будут записаны в одномерный не ассоциативный массив, и затем он будет преобразован в формат JSON и подставлен на то место, где указан этот запрос.
- Если использовать запрос данных из БД, возвращающий много строк с несколькими столбцами (таблица значений), то все значения будут записаны в двумерный не ассоциативный массив (массив строк, в каждом элементе которого массив значений столбцов), и затем он будет преобразован в формат JSON и подставлен на то место, где указан этот запрос.
Тестирование
Вы можете протестировать запрос, однако специальные поля и запросы не будут подставлены, так как заранее неизвестны их значения.
В случае ошибки будет выведена причина ошибки запроса, в случае успеха – ответ на запрос.
Как выбрать интересующие данные в ответе на запрос для их дальнейшего вывода в сообщении или сохранении, читайте здесь.