Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Enviar um vídeo para os rascunhos de um criador no TikTok através da API

As APIs do TikTok enviam um vídeo para os rascunhos de um criador com o fluxo de carregamento: a Content Posting API carrega-o com /v2/post/publish/inbox/video/init/ ao abrigo do scope video.upload, e o TikTok envia ao criador uma notificação na caixa de entrada para o editar e publicar na aplicação. A API for Business faz o mesmo com upload_to_draft em /business/video/publish/, ou com is_draft em publicações de fotos.

O easyCoexistence publica vídeos e publicações de fotos do TikTok com publish_tiktok_post, a partir do Claude, do ChatGPT ou da sua própria plataforma, de imediato ou numa data e hora até 90 dias à frente, com cada publicação em fila visível no ecrã Posts até sair.

video.upload

O scope que o TikTok define para partilhar conteúdo na conta do criador como rascunho, para editar e publicar posteriormente no TikTok.

5 pending

O número máximo de partilhas pendentes que a Content Posting API permite em qualquer período de 24 horas, limite definido pelo TikTok para reduzir o spam.

SEND_TO_USER_INBOX

O estado /business/publish/status/ indica quando um rascunho foi carregado e o TikTok notificou a caixa de entrada do criador.

6 a minute

Pedidos que cada token de acesso de utilizador pode enviar para o endpoint de carregamento da Content Posting API.

Ignored

O que acontece aos outros campos de post_info quando upload_to_draft é true em /business/video/publish/.

Em que se diferencia um rascunho de uma publicação direta?

Em quem carrega em Publicar. Uma publicação direta fica online assim que o TikTok a processa; um rascunho chega à caixa de entrada do TikTok do criador e só é publicado quando o criador o abre, o edita como quiser e o publica. A diferença atravessa as duas APIs de publicação do TikTok:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent in the call

Como é que a Content Posting API carrega um rascunho?

Com um POST para https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, um token de acesso de utilizador com video.upload e um objeto source_info. PULL_FROM_URL faz com que o TikTok obtenha o vídeo de um domínio ou prefixo de URL que a aplicação tenha verificado; FILE_UPLOAD devolve um upload_url, para o qual o ficheiro é enviado em blocos com pedidos PUT. O publish_id devolvido segue para /v2/post/publish/status/fetch/, as fotos usam /v2/post/publish/content/init/ com post_mode definido como MEDIA_UPLOAD, e o TikTok pede às aplicações que indiquem aos utilizadores que abram a notificação da caixa de entrada para continuar a editar no TikTok:

Upload a video to the creator's inbox from a URL
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
  -H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -d '{
    "source_info": {
      "source": "PULL_FROM_URL",
      "video_url": "https://media.example.com/tiktok/draft.mp4"
    }
  }'

# data.publish_id: pass it to /v2/post/publish/status/fetch/

Que limites se aplicam aos rascunhos da Content Posting API?

O TikTok documenta-os na sua referência de carregamento, e cada um é devolvido pela chamada init quando se aplica:

  • Rascunhos pendentes: no máximo 5 partilhas pendentes em qualquer período de 24 horas; acima disso, spam_risk_too_many_pending_share com HTTP 403.
  • Pedidos: 6 por minuto por token de acesso de utilizador, depois rate_limit_exceeded com HTTP 429.
  • Scope: um token sem video.upload recebe scope_not_authorized com HTTP 401.
  • Media: PULL_FROM_URL de um domínio ou prefixo que a aplicação não verificou recebe url_ownership_unverified com HTTP 403.

Como é que a API for Business carrega um rascunho?

Com os seus endpoints de publicação e mais um campo em post_info. Em /business/video/publish/, upload_to_draft definido como true envia o vídeo como rascunho, e o TikTok ignora os outros campos de post_info; em /business/photo/publish/, is_draft mantém apenas o título e a legenda. Ambos precisam de video.upload no token da conta, que /tt_user/token_info/get/ lista, e sem esse scope o proprietário aprova o carregamento de rascunhos voltando a autorizar a aplicação. O ficheiro multimédia continua num URL verificado, o estado mostra SEND_TO_USER_INBOX, e o criador encontra o rascunho através da notificação da caixa de entrada:

Send a video to the creator's drafts on the API for Business
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/draft.mp4",
    "post_info": {
      "upload_to_draft": true,
      "is_brand_organic": false,
      "is_branded_content": false
    }
  }'

O que faz o criador com o rascunho?

Termina-o no TikTok. A notificação da caixa de entrada abre o vídeo ou as fotos carregados no editor do TikTok, onde o criador os revê, edita e publica. Na Content Posting API, o estado passa de SEND_TO_USER_INBOX para PUBLISH_COMPLETE quando o criador publica a partir do rascunho, e o TikTok observa que um rascunho pode originar mais do que uma publicação.

O easyCoexistence envia rascunhos?

Não: publish_tiktok_post publica. Chama /business/video/publish/ ou /business/photo/publish/ sem upload_to_draft nem is_draft, pelo que a publicação fica online assim que o TikTok a processa. Para reter uma publicação para revisão, agende-a com scheduled_at, entre 1 minuto e 90 dias à frente: fica à espera em Próximas no ecrã Posts, update_scheduled_post altera a hora, a legenda ou o título de uma publicação de fotos, e cancel_scheduled_post impede que seja publicada antes de sair.

Erros comuns

  • Pedir video.publish para enviar rascunhos. Os rascunhos precisam de video.upload, o scope que o TikTok descreve como partilha de conteúdo como rascunho.
  • Definir uma legenda num rascunho de vídeo através da API for Business. Com upload_to_draft definido como true, o TikTok ignora o resto de post_info.
  • Carregar rascunhos mais depressa do que os criadores publicam. A Content Posting API para nas 5 partilhas pendentes em 24 horas, com spam_risk_too_many_pending_share.
  • Deixar os utilizadores sem indicação para a caixa de entrada. O TikTok pede às aplicações que lhes digam para abrir a notificação da caixa de entrada para concluir a publicação.
Fazer isto com a EasyCoexistence

A partir de US$ 9 por ligação por mês, descendo até US$ 0.75 à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

A API do TikTok pode guardar um vídeo como rascunho?

Sim. O fluxo de carregamento coloca-o na caixa de entrada do TikTok do criador, onde o criador o edita e publica; o token precisa do scope video.upload.

Onde aparece um rascunho enviado pela API?

Na aplicação do TikTok, atrás de uma notificação da caixa de entrada que abre o vídeo no editor do TikTok para o criador o concluir.

Um rascunho do TikTok pode manter a minha legenda?

Na API for Business, um rascunho de foto mantém o título e a legenda, enquanto um rascunho de vídeo descarta os outros campos de post_info.

Um rascunho do TikTok pode dar mais do que uma publicação?

Sim. O TikTok observa que um rascunho pode originar mais do que uma publicação, e na Content Posting API o estado passa para PUBLISH_COMPLETE quando o criador publica a partir dele.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em