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.
O scope que o TikTok define para partilhar conteúdo na conta do criador como rascunho, para editar e publicar posteriormente no TikTok.
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.
O estado /business/publish/status/ indica quando um rascunho foi carregado e o TikTok notificou a caixa de entrada do criador.
Pedidos que cada token de acesso de utilizador pode enviar para o endpoint de carregamento da Content Posting API.
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 posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent 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:
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_sharecom HTTP 403. - Pedidos: 6 por minuto por token de acesso de utilizador, depois
rate_limit_exceededcom HTTP 429. - Scope: um token sem video.upload recebe
scope_not_authorizedcom HTTP 401. - Media:
PULL_FROM_URLde um domínio ou prefixo que a aplicação não verificou recebeurl_ownership_unverifiedcom 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:
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.
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