Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

URLs de média do TikTok: domínios verificados e prefixos de URL

A API for Business do TikTok transfere os ficheiros de média a partir de URLs: video_url, custom_thumbnail_url e photo_images. Cada URL tem de estar num domínio ou prefixo de URL cuja propriedade a aplicação do programador tenha verificado. Um domínio verifica-se com um registo DNS TXT e um prefixo com um ficheiro de assinatura colocado na respetiva pasta, através de /business/property/add/ e /business/property/verify/, com o app_id e o secret da aplicação.

O easyCoexistence serve os seus ficheiros ao TikTok a partir do seu próprio prefixo de URL verificado: o publish_tiktok_post aceita uma ligação HTTPS vinda do Claude, do ChatGPT ou do seu próprio código e transmite o ficheiro a partir dela quando o TikTok o transfere, por isso o seu domínio não precisa de verificação.

Nov 16, 2023

Desde então, o TikTok recusa URLs de vídeo que não estejam num domínio ou prefixo de URL verificado.

Oct 15, 2025

Desde então, os endpoints de propriedades de URL exigem também o secret da aplicação do programador.

1 / 2

Valores de property_type: 1 para um domínio, 2 para um prefixo de URL.

0, 1, 2

Valores de property_status: pending, verified e not verified, que significa que a tentativa falhou e tem de ser repetida.

Apr 7, 2023

Os programadores que publicaram vídeos antes dessa data viram os domínios dos URLs desses vídeos marcados como verificados automaticamente.

5 MB

A maior imagem que /business/comment/image/upload/ aceita, como dados de formulário multipart, para um comentário ou resposta.

Que URLs o TikTok transfere?

Cada campo de média nos dois endpoints de publicação é um URL que o TikTok obtém por si próprio depois de aceitar a chamada, pelo que o ficheiro tem de continuar acessível até a transferência terminar:

  • video_url: o vídeo, que o TikTok recomenda manter válido durante pelo menos 30 minutos.
  • custom_thumbnail_url: uma imagem a usar como capa do vídeo.
  • photo_images: até 35 imagens para uma publicação de fotos.
  • Tempo limite: o TikTok dá uma hora à transferência e, depois, falha a publicação com video_pull_failed ou photo_pull_failed.

Qual é a diferença entre um domínio e um prefixo de URL?

Aquilo de que consegue provar a propriedade e, por isso, quais os URLs que contam como verificados. Um domínio serve para ficheiros num alojamento que controla; um prefixo serve para uma pasta num alojamento onde só pode carregar ficheiros. As regras do TikTok para cada tipo de propriedade:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

Como se verifica uma propriedade?

Através de duas chamadas que se autenticam com o app_id e o secret da aplicação do programador, e não com um token de conta, com a prova colocada entre elas:

  • Adicionar: POST /business/property/add/ com url_property_meta, com property_type e url; a resposta devolve signature e, num prefixo, file_name, com property_status 0.
  • Provar: colocar a signature num registo DNS TXT, para um domínio, ou num ficheiro público com o nome file_name, com uma única extensão .txt, dentro de um prefixo.
  • Verificar: POST /business/property/verify/ com o mesmo url_property_meta; property_status 1 significa verificado, e 2 significa que a tentativa falhou.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

Como se listam ou removem propriedades?

GET /business/property/list/ com app_id e secret devolve url_property_info_list, com cada entrada a incluir property_type, url, property_status, signature e file_name. Os subdomínios de um domínio verificado contam como verificados sem chamada própria, mas só aparecem na lista se tiverem sido adicionados. POST /business/property/delete/ com app_id, secret e url_property_meta elimina uma propriedade que a aplicação já não possui nem controla.

Pode carregar um ficheiro em vez de um URL?

Não para publicações. A Accounts API publica apenas a partir de URLs, incluindo rascunhos, e o seu único endpoint de carregamento, /business/comment/image/upload/, recebe a imagem de um comentário como dados de formulário multipart, em JPG, JPEG, WebP ou PNG até 5 MB, e devolve um image_uri para um comentário ou resposta. O carregamento de ficheiros em blocos pertence à Content Posting API em developers.tiktok.com, uma API separada com as suas próprias aplicações, em que o método de transferência se chama FILE_UPLOAD.

O que acontece com um URL que não está verificado?

O TikTok recusa publicar a partir dele. A referência da API for Business enuncia a regra para vídeos e fotos, mas não indica nenhum código de resposta próprio, por isso leia o código e a mensagem da resposta. A Content Posting API em developers.tiktok.com dá o nome url_ownership_unverified ao mesmo caso, com HTTP 403. Para testar o endpoint de vídeo antes de verificar qualquer propriedade, o TikTok publica um URL de vídeo de teste que não precisa de verificação:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

Como é que o easyCoexistence entrega os seus ficheiros ao TikTok?

Através de um único prefixo de URL verificado próprio, https://easycoexistence.com/api/social/media/. O publish_tiktok_post aceita a sua ligação HTTPS, recusa http:// antes de enviar seja o que for, e entrega ao TikTok uma ligação sob esse prefixo com um token assinado que identifica o seu ficheiro, expira ao fim de 6 horas e mantém a extensão do ficheiro. Quando o TikTok a obtém, o easyCoexistence verifica o token, confirma que a sua ligação usa HTTPS num endereço público e transmite o ficheiro diretamente a partir da sua ligação, incluindo pedidos de intervalo (range) e redirecionamentos, sem o guardar. Se a sua ligação falhar, o TikTok não consegue transferir o ficheiro e a publicação falha.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

Erros comuns

  • Verificar um subdomínio e alojar os ficheiros no domínio principal. Um video.example.com verificado cobre os seus próprios subdomínios, não o example.com em si.
  • Servir o ficheiro de assinatura do prefixo através de um redirecionamento. O TikTok não segue redirecionamentos para um prefixo de URL e trata uma resposta 3xx como inválida.
  • Guardar o ficheiro de assinatura como nome.txt.txt. O TikTok quer que o nome do ficheiro coincida com file_name, com uma única extensão .txt.
  • Apagar o ficheiro logo após a chamada de publicação. O TikTok transfere-o depois, durante até uma hora, e falha a publicação se a ligação deixar de funcionar.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Porque é que o TikTok exige URLs de média verificados?

O TikTok diz que verificar a propriedade dos URLs de vídeo o ajuda a cumprir as suas políticas sobre conteúdos protegidos por direitos de autor e a segurança dos utilizadores.

Um domínio TikTok verificado cobre os seus subdomínios?

Sim. Os subdomínios de um domínio verificado contam como verificados, embora /business/property/list/ só os mostre se tiverem sido adicionados.

A API for Business do TikTok pode publicar a partir de uma ligação S3 ou CDN?

Sim, quando a ligação está sob um domínio ou prefixo de URL que a aplicação verificou, por exemplo um prefixo num bucket ou num caminho de CDN que controla.

As publicações de fotos também precisam de URLs verificados?

Sim. O endpoint de fotos do TikTok indica que as publicações de fotos não podem ser feitas a partir de URLs de fotos não verificados.

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