Отправка созданных видео на свой сервер
Окно «Интеграция с HTTP-клиентом» отправляет каждое созданное видео на Ваш адрес в сети. Отправка выполняется сразу после того, как видео готово. По желанию файл удаляется с устройства после успешной отправки. Так созданное видео сразу оказывается в Вашем боте, в сценарии автоматизации или в своём хранилище.
Что именно отправляется
Приложение выполняет запрос POST на Ваш адрес. Тело запроса - форма multipart/form-data. Файл лежит в поле video, тип файла - video/mp4, имя - имя созданного файла.
- Пары из поля «Тело запроса (необязательно):» добавляются полями той же формы.
- Пары из поля «Дополнительные параметры запроса (необязательно):» добавляются заголовками.
Срок на соединение - 15 секунд. Ещё 15 секунд отведено на ответ. Успехом считается любой код ответа из диапазона 2xx. Изменить эти сроки в приложении нельзя.
Как включить отправку
- Откройте проект и окно «Интеграции проекта».
- В карточке «Интеграция с HTTP-клиентом» нажмите «Открыть».
- Включите переключатель «Отправлять видео по URL». До этого все поля ниже серые.
- Впишите адрес под подписью «URL для отправки видео:».
- При необходимости заполните «Дополнительные параметры запроса (необязательно):» и «Тело запроса (необязательно):».
- Решите, нужно ли «Удалять видео после отправки».
- Нажмите «Сохранить».
Без нажатия «Сохранить» настройки не запишутся. При закрытии окна появится вопрос с заголовком «Подтверждение» и текстом «Изменения не сохранены. Вы уверены, что хотите закрыть окно?». Кнопки в нём - «Да» и «Нет», по умолчанию выбрано «Нет».
Поля окна
| Поле | Что делает | По умолчанию |
|---|---|---|
| «Отправлять видео по URL» | Главный переключатель. Пока он выключен, остальные поля серые | Выключен |
| «URL для отправки видео:» | Адрес приёмника. Пробелы по краям снимаются при сохранении | Пусто |
| Кнопка справа от поля адреса | Отправляет пробный запрос. В подсказке к ней стоит «Отправить пробный запрос» | - |
| «Дополнительные параметры запроса (необязательно):» | Заголовки запроса, по одному в строке, через двоеточие | Пусто |
| «Тело запроса (необязательно):» | Дополнительные поля формы, по одной паре в строке, через двоеточие | Пусто |
| «Удалять видео после отправки» | Удаляет файл с устройства после успешного ответа | Выключен |
| «Сохранить» | Записывает настройки в открытый проект | - |
Строка результата сохранения показывает «Настройки успешно сохранены!» или «Настройки не сохранены».
Пробный запрос отправляет оригинал
Кнопка проверки отправляет не созданное видео, а видео из окна предпросмотра проекта. Это оригинал, который Вы загрузили в проект. Приложение отправит его целиком и на тот адрес, который стоит в поле.
Учитывайте это, когда проверяете чужой или публичный приёмник: на него будет отправлен Ваш оригинал. Об этом же сказано в подсказке к полю адреса: «Используется POST-запрос с multipart/form-data. Кнопка справа от поля отправляет пробное видео. Берётся то, которое сейчас в окне превью проекта.»
Проверка перед пробным запросом отказывает в двух случаях.
| Текст отказа | Что делать |
|---|---|
| «Пожалуйста, укажите URL.» | Впишите адрес приёмника |
| «Видео в окне превью проекта не существует. Пожалуйста, выберите другое» | Откройте в предпросмотре видео, файл которого есть на диске |
Ответ показывает бегущая строка под полем адреса.
| Строка | Что означает |
|---|---|
Устанавливаю соединение... | Запрос отправлен, ответа ещё нет |
Запрос успешно отправлен! Статус: {код} | Приёмник ответил кодом из диапазона 2xx |
Ошибка. Статус: {код} | Приёмник ответил, но код другой |
Ошибка. Запрос не выполнен: {причина} | Запрос выполнить не удалось |
Ошибка сети: {текст} | Сеть не отвечает или адрес неверен |
Непредвиденная ошибка | Причина неизвестна |
Не удалось подготовить запрос: {причина} | Запрос не собрался |
Заголовки и тело запроса
Оба поля заполняются одинаково. Одна пара в строке, имя и значение через двоеточие. Регистр букв и пробелы важны. Заголовок авторизации вписывается в «Дополнительные параметры запроса (необязательно):».
Правила такие:
- имя заголовка не может содержать пробел, табуляцию, кавычку, апостроф, запятую, точку с запятой и скобки;
- имя поля тела может быть любым непустым;
- при повторе имени остаётся последняя строка, предыдущая не отправляется;
- перевод строки в значении делает запрос неотправимым.
Замечания о неверных строках показываются только при пробном запросе. В обычной работе их на экране нет. Неверная строка отбрасывается, а запрос всё равно отправляется - без неё. Настроили один раз с ошибкой, и все видео отправляются без нужного заголовка. Поэтому после правки этих полей всегда нажимайте кнопку пробного запроса.
При пробном запросе открывается окно с заголовком «Проверка запроса». В нём стоит текст «Пожалуйста, поправьте эти строки: отправлены будут только остальные.» и список замечаний.
| Замечание | Что означает |
|---|---|
Строка {N}: нет двоеточия, поэтому заголовок из неё не получается. | В строке нет двоеточия |
Строка {N}: имя "ИМЯ" уже было выше, отправится только эта строка. | Имя повторяется |
Строка {N}: имя пустое, а без имени отправлять нечего. | Перед двоеточием пусто |
Строка {N}: в имени "ИМЯ" есть то, чего в заголовке не бывает: ПЕРЕЧЕНЬ. | В имени недопустимый знак, он назван словом |
Строка {N}: в значении есть перевод строки, и с ним запрос не отправится вовсе. | Значение занимает две строки |
Для поля тела первое замечание кончается иначе: «...поэтому поле из неё не получается.»
Удаление после отправки
Переключатель «Удалять видео после отправки» по умолчанию выключен. Файл удаляется только при успешном ответе. Ошибка отправки файл не трогает.
Опасность понятная: приёмник, который отвечает кодом 200 и теряет файл, приведёт к удалению видео у Вас. Повторов у отправки нет, второй копии тоже. Включайте удаление только тогда, когда приёмник проверен.
Файл, занятый другой программой, удаление не отменяет. Статус будет «Удаляю...», а удаление состоится позже.
Что должен уметь приёмник
- принимать запрос
POSTс теломmultipart/form-data; - читать файл из поля
video; - отвечать за 15 секунд кодом из диапазона 2xx;
- работать по адресу, который доступен с этого устройства.
Проверка сертификата у приложения самая обычная. Поэтому свой сертификат не подойдёт. Для приёмника на этом же устройстве достаточно локального адреса.
Что видно в таблице результатов
| Статус | Что означает |
|---|---|
| «Отправляю по HTTP...» | Запрос выполняется |
| «Готово/Отправлено по HTTP» | Видео создано и отправлено |
| «Отправлено по HTTP. Удалено» | Отправлено, файл удалён с устройства |
| «Удаляю...» | Файл ещё удаляется |
| «Ошибка при удалении» | Файл удалить не удалось |
| «Ошибка отправки по HTTP» | Отправка не удалась |
HTTP Ошибка: {код} | Приёмник ответил кодом не из диапазона 2xx |
Частые вопросы
Видео не отправилось. Приложение попробует ещё раз?
Нет. Повторов нет вовсе. Строка таблицы результатов получает статус ошибки, и на этом всё. Отправьте файл сами или запустите создание видео заново.
Почему не работает мой заголовок авторизации?
Скорее всего, строка написана с ошибкой и отброшена молча. Нажмите кнопку пробного запроса. Окно «Проверка запроса» назовёт номер строки и причину.
Приёмник получает файл не полностью. Что делать?
Скорее всего, не хватает 15 секунд на ответ. Уменьшите размер файла или ускорьте приёмник. Изменить срок в приложении нельзя.
Видны ли эти настройки в другом проекте?
Нет. Адрес и оба текстовых поля записываются в открытый проект. В новом проекте впишите их заново.
Можно ли отправлять на адрес внутри своего устройства?
Да. Достаточно адреса вида http://127.0.0.1:8080/upload. Выход в интернет для этого не нужен.
Почему пробный запрос прошёл, а в работе видео не отправляются?
Проверьте главный переключатель «Отправлять видео по URL» и кнопку «Сохранить». Кнопка проверки работает и с несохранёнными настройками, а обычная отправка - только с сохранёнными.