AiVideoEditor
Начните бесплатно
Меню

Проверено 2026-11-11 · версия API 2026-11-09 · Читать Markdown

Публикация и планирование

Пост AiVideoEditor имеет версионируемый черновик и независимые доставки для выбранных аккаунтов. Сохранение черновиков мягкое; успешное сохранение не означает, что каждое назначение можно публиковать.

Подготовка поста

  1. Прочитайте /api/v1/accounts и /api/v1/capabilities с предполагаемым ключом.
  2. Загрузите и финализируйте необходимые медиа.
  3. Создайте черновик с POST /api/v1/posts или отредактируйте с PATCH /api/v1/posts/{id}. Указывайте текущий expectedVersion при правках и сохраняйте возвращенную версию.
  4. При необходимости задайте формат назначения и явные переопределения вариантов для отдельных аккаунтов. Справочник API определяет поля запроса.
  5. Проверьте с POST /api/v1/posts/{id}/validate. HTTP 200 может содержать valid: false; просмотрите каждую проблему перед отправкой. Недействительные аккаунты не удаляются молча из аудитории.

Публикация сейчас или позже

POST /posts/{id}/publish отправляет текущий черновик. POST /posts/{id}/schedule требует scheduledAt, timezone и expectedVersion. Запланированный момент должен быть в будущем и в пределах 90 дней. Храните метку времени UTC ISO и отдельный часовой пояс отображения IANA; разрешайте неоднозначности летнего времени до отправки.

Используйте отдельный Idempotency-Key для каждой новой мутации. Храните этот ключ и точное тело запроса до отправки. После таймаута повторите идентичный запрос с тем же ключом. Меняйте ключ только при намеренном запросе новой операции. Устаревшая правка черновика или планирование возвращает revision_conflict; перечитайте и просмотрите последний контент, а не перезаписывайте его вслепую.

Ответ 202 означает принятие к отправке. Это не доказательство публикации. Записывайте ID доставок и наблюдайте GET /posts/{id} или подписанные клиентские вебхуки. Используйте ограниченный опрос с нарастающими задержками; останавливайтесь при терминальном результате или передаче человеку, а не зацикливайтесь бесконечно.

Результаты по назначениям

Доставки могут завершаться независимо. Одно назначение может опубликоваться, пока другое требует переподключения или согласия. Показывайте каждое состояние и нативную ссылку на пост, когда она есть. Повторяйте только подходящий известный сбой с помощью POST /deliveries/{id}/retry. Успешные назначения не должны пересоздаваться для восстановления неудавшегося. Неизвестный внешний результат требует сверки или проверки, а не новой отправки.

Отменяйте с POST /deliveries/{id}/cancel, пока работа остается безопасно не взятой в работу. too_late_to_cancel означает, что отправка продвинулась за пределы безопасной отмены; это не означает, что внешний пост удален.

Проверка человека в TikTok

Прочитайте /accounts/{id}/tiktok/settings, чтобы узнать текущие настройки создателя и доступные варианты приватности. Чтение настроек или сохранение черновика не дает согласия. consent_required включает безопасную передачу requiresAction в аутентифицированный композер. Уполномоченный человек просматривает точное видео, подпись к посту и назначение и явно подтверждает там требуемые выборы. Ключи продукта и инструменты MCP не могут подтвердить за него. Изменения контента или идентичности требуют новой проверки. Передача сама по себе не дает участия или доступа.

Элементы управления композера

Используйте Добавить медиа, чтобы загрузить файл или выбрать существующий элемент библиотеки. Подпись к посту общая, пока Настроить контент не создаст вариант для конкретного аккаунта. Инструменты эмодзи и хештегов вставляют обычный текст в позицию курсора.

Параметры публикации группирует настройки выбранного аккаунта. Обязательные выборы остаются видимыми; необязательные группы остаются свернутыми. Изменения применяются только к этому аккаунту. Предпросмотр показывает действующий черновик без сохранения или отправки, включая незавершенные черновики; нативное представление платформы может отличаться.

Используйте ссылки на приватные ресурсы для запланированных обложек и миниатюр. Альтернативы с публичными URL должны оставаться доступными в момент доставки. Содержимое субтитров хранится вместе с неизменяемыми настройками, а не зависит от временного локального файла. Загрузка документов LinkedIn в настоящее время принимает PDF; форматы Office остаются недоступными, пока не реализована проверка подписи.

См. справочник возможностей для канонических элементов управления и ограничений интеграции. Новое поведение форматов и подтверждения требует соответствующих миграций базы данных перед развертыванием.