Основи публікації відео за допомогою 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, щоб переглянути приклади запитів, обов'язкові поля та повний життєвий цикл завантаження.