Основы публикации видео с помощью API
Краткое описание того, как Upload24 обрабатывает аутентификацию, загрузку и отслеживание состояния при автоматизации доставки видео.
Автоматизация становится проще, когда поток загрузки предсказуем. В Upload24 API разработан вокруг одного практического вопроса: как переместить файл из вашей системы в несколько подключенных социальных аккаунтов, не теряя контроля над авторизацией, планированием и состоянием доставки?
Ответ заключается в четком разделении задач. Вы аутентифицируетесь один раз, выбираете метод загрузки, который соответствует размеру файла и инфраструктуре, а затем опрашиваете конечную точку состояния, которая сообщает вам, что произошло для каждой связанной учетной записи.
Доступ - прежде транспорта
Upload24 использует аутентификацию на предъявителя для создания и управления ключами API, но сами конечные точки загрузки также принимают необработанный ключ API через заголовок X-Api-Key. Такое разделение позволяет управлять ключами внутри панели управления, а автоматизация выполняется без пользовательской сессии.
Это также означает, что API учитывает интересы арендатора с первого запроса. Правильный ключ разрешает контекст арендатора, поэтому каждая загрузка, проверка статуса и повторная попытка остается привязанной к правильному рабочему пространству.
Три потока загрузки покрывают различные рабочие нагрузки
Для небольших или простых интеграций кратчайшим путем является загрузка формы с несколькими частями: отправьте метаданные и файл в одном запросе. Если ваш бэкэнд уже управляет передачей объектов, используйте поток с предварительным назначением одной части. Для больших файлов или более строгих требований к устойчивости к внешним воздействиям предварительное назначение нескольких частей позволяет загружать файлы по частям и завершать сеанс после сбора каждого ETag.
- Используйте /api/upload, если вам нужна самая простая форма запроса.
- Используйте /api/upload/presign-put, когда ваш сервер или рабочий загружает один объект непосредственно в хранилище.
- Используйте /api/upload/multipart, когда большие файлы или нестабильная сеть делают возобновляемую передачу более важной, чем краткость.
Один запрос на загрузку может распространяться на несколько учетных записей
Именно эту часть многие команды недооценивают. В Upload24 одна загрузка может быть адресована нескольким связанным аккаунтам, и у каждого адресата есть свой статус, внешний идентификатор и данные о неудаче. Полезная нагрузка публичного статуса сохраняет видимость результатов на уровне аккаунта, а не сводит их к одному флагу успеха.
С операционной точки зрения это имеет значение, поскольку квота начисляется на целевой аккаунт, а не на HTTP-запрос. Если вы публикуете один актив на три канала, платформа рассматривает это как три действия по доставке.
Производственное использование - это в основном защитные ограждения
API устанавливает ограничения, которые стоит заблаговременно смоделировать в своем клиенте: файлы должны оставаться в пределах 2 ГБ, загрузка должна включать как минимум один связанный аккаунт, запланированные посты не могут быть выведены за пределы допустимого окна планирования, а метаданные, специфичные для YouTube, становятся обязательными, как только вы выбираете поля YouTube.
Такая проверка полезна, потому что она перемещает ошибки интеграции ближе к вызывающей стороне. Если вы отразите те же проверки в собственном пользовательском интерфейсе или рабочих заданиях, вы получите меньше неудачных попыток загрузки и более четкое поведение при повторных попытках.
Готовы подключить поток загрузки к своему продукту?
Откройте документацию API, чтобы узнать примеры запросов, обязательные поля и полный жизненный цикл загрузки.