Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Testar a API do TikTok antes da aprovação: o sandbox

O modo sandbox do TikTok for Developers permite testar a integração de uma app antes de a submeter à revisão: até 5 sandboxes, cada uma com uma configuração separada da versão em produção, testadas por até 10 contas de utilizadores de teste, adicionadas com o respetivo início de sessão. Deixa de fora a Content Posting API para vídeos públicos e a Data Portability API.

O easyCoexistence liga uma conta do TikTok que é sua ao iniciar sessão no TikTok, através da sua própria app de programador da API for Business, para que possa experimentar publicações, comentários e estatísticas a partir do Claude, do ChatGPT ou do seu próprio código, sem sandbox nem revisão de app da sua parte.

5 sandboxes

No máximo 5 sandboxes que o TikTok for Developers permite criar, para testar integrações sem submeter a app à revisão.

10 accounts

No máximo 10 utilizadores de teste que pode adicionar; adicionar uma conta que é sua exige as respetivas credenciais de acesso.

Dec 1, 2026

Quando o TikTok descontinuar as contas sandbox da API for Business, aconselha os programadores a criar uma conta de teste em produção.

30 QPM

Limite por endpoint nas contas sandbox da API for Business, além de uma consulta por segundo e 1,000 por dia.

1 hour

Tempo que os utilizadores de teste recém-adicionados podem levar a aparecer na página da app após uma atualização.

Qual é o modo sandbox do TikTok?

Um ambiente restrito em developers.tiktok.com onde a integração de uma app é executada antes da revisão. O TikTok descreve-o como uma forma de experimentar integrações sem submeter a app e de testar configurações sem comprometer a versão em produção. Cada sandbox mantém os seus próprios dados da app e produtos, e os utilizadores de teste que adiciona experimentam-no.

Como se cria um sandbox?

Na página da app no portal para programadores. Eis os passos do TikTok, depois de ter uma conta de programador, em que criar ou aderir a uma organização é recomendado mas não obrigatório:

  • Abra Manage apps, selecione ou ligue a app e mude o interruptor ao lado do nome para Sandbox.
  • Clique em Create Sandbox, dê-lhe um nome e, se quiser, clone a versão em produção ou outro sandbox.
  • Edite App details, adicione os produtos a testar e clique em Apply changes.
  • Adicione mais com o botão [+] no painel da esquerda, até 5 no total.

Como funcionam os utilizadores de teste?

São as contas do TikTok que experimentam o sandbox. Em Sandbox settings, Target users, escolha Add account, inicie sessão com a conta e aceite os Termos de Serviço para Programadores do TikTok. O TikTok indica que uma conta que é sua precisa das respetivas credenciais de acesso para ser adicionada e que novos utilizadores podem demorar até uma hora a aparecer após uma atualização. Podem ser adicionados até 10 e depois autorizados através do Login Kit e dos produtos que dependem dele, sendo necessário um decodificador de URL para esse passo.

O que o modo sandbox deixa de fora?

Publicações públicas e portabilidade de dados. A página de sandbox do TikTok indica que o modo sandbox não dá acesso à Content Posting API para vídeos públicos nem à Data Portability API. As publicações públicas também dependem de mais do que a revisão: até um cliente da Content Posting API passar na auditoria do TikTok, publica com visibilidade SELF_ONLY, a partir de contas privadas, para até 5 utilizadores em 24 horas.

Como se insere o sandbox na revisão da app?

É daqui que vem a demonstração da primeira submissão. As diretrizes de revisão do TikTok exigem que uma app que nunca foi aprovada demonstre a sua integração num sandbox no portal para programadores. Uma configuração de sandbox pode depois ser importada para um rascunho em modo Production, o que substitui esse rascunho, e Revert to Live version devolve à configuração aprovada.

Há um sandbox na API for Business?

Há um para anúncios, e está a acabar. As contas sandbox da API for Business são contas de anúncios, acessíveis em https://sandbox-ads.tiktok.com/open_api com dados de relatório simulados, uma por app de programador, e limitadas a uma consulta por segundo, 30 por minuto e 1,000 por dia em cada endpoint. Os endpoints suportados abrangem campanhas, grupos de anúncios, anúncios, carregamentos de criativos, relatórios, termos e identidades, sem endpoint da Accounts API em business/. O TikTok descontinua-as a 1 de dezembro de 2026, aconselhando uma conta de teste em produção.

Como se testa a Accounts API sem sandbox?

Numa conta real que é sua e que reserva para testes. Autorize a app com essa conta, verifique os scopes do token com /tt_user/token_info/get/ e experimente publicar com o URL de vídeo de teste que o TikTok disponibiliza para /business/video/publish/, que não exige verificação de URL. O guia de primeiros passos do TikTok também aponta para a sua coleção Postman da API for Business para experimentar chamadas. As publicações de teste contam para os limites dessa conta, de seis por minuto e 15 por dia.

Como encaixa o easyCoexistence nos testes?

Sem nada para configurar do lado do TikTok. Uma conta do TikTok que é sua liga-se ao easyCoexistence ao iniciar sessão no TikTok, através da própria app de programador da API for Business do easyCoexistence, por isso não há sandbox, revisão ou auditoria sua que tenha de esperar. O Claude, o ChatGPT ou o código da sua plataforma publicam, respondem a comentários e leem estatísticas nessa conta, através das mesmas ferramentas que as contas dos seus clientes vão usar.

Erros comuns

  • Planear testes de publicações públicas num sandbox. O modo sandbox não dá acesso à Content Posting API para vídeos públicos.
  • Adicionar um utilizador de teste sem as credenciais de acesso. O TikTok pede as credenciais de uma conta que é sua ao adicioná-la como utilizador de teste.
  • Começar novos testes em contas sandbox de anúncios da API for Business. O TikTok descontinua-as a 1 de dezembro de 2026 e aponta para contas de teste em produção.
  • Submeter uma app nunca aprovada sem vídeo de demonstração do sandbox. As diretrizes do TikTok exigem uma demonstração da integração num sandbox para uma primeira revisão.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, a diminuir à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Porque não aparecem os meus utilizadores de teste do TikTok no sandbox?

O TikTok indica que os utilizadores de teste recém-adicionados podem demorar até uma hora a aparecer na página da app após uma atualização. Adicionar uma conta que é sua exige também as respetivas credenciais de acesso.

Um sandbox do TikTok precisa de uma app de programador separada?

Não. Os sandboxes vivem dentro da mesma app no developers.tiktok.com, até 5, cada um com os seus próprios dados e produtos, separados da versão em produção.

As publicações de teste numa conta real do TikTok contam para os seus limites?

Sim. As publicações feitas durante o teste da Accounts API numa conta real contam para os limites de seis por minuto e 15 por dia, como qualquer outra publicação.

O que deve mostrar um vídeo de demonstração do sandbox do TikTok?

A integração de ponta a ponta, com cada scope pedido em uso. As diretrizes de revisão do TikTok pedem que uma app nunca aprovada a demonstre num sandbox, e uma demonstração que salte o fluxo ou um scope é uma causa comum de rejeição.

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