TikTok API testen vóór goedkeuring: de sandbox
Met de sandboxmodus van TikTok for Developers test je de integratie van een app voordat je die ter beoordeling indient: tot 5 sandboxen, elk een configuratie los van de live app, getest door tot 10 testaccounts die je met een eigen login toevoegt. De Content Posting API voor openbare video's en de Data Portability API ontbreken erin.
easyCoexistence koppelt een TikTok-account dat je zelf bezit door in te loggen bij TikTok, via de eigen developer-app van easyCoexistence voor de API for Business.
Tot 5 sandboxen kun je aanmaken bij TikTok for Developers, om integraties te testen zonder de app ter beoordeling in te dienen.
Je kunt tot 10 testgebruikers toevoegen; een account dat je zelf bezit, vraagt om de inloggegevens.
Wanneer TikTok de sandboxaccounts van de API for Business uitfaseert, adviseert het ontwikkelaars om een testaccount in productie aan te maken.
Limiet per endpoint in de sandboxaccounts van de API for Business, naast één query per seconde en 1.000 per dag.
Hoe lang nieuw toegevoegde testgebruikers kunnen duren voordat ze na een vernieuwing op de app-pagina verschijnen.
Wat is de sandboxmodus van TikTok?
Een beperkte omgeving op developers.tiktok.com waarin de integratie van een app draait vóór de beoordeling. TikTok omschrijft het als een manier om integraties uit te proberen zonder de app in te dienen, en om configuraties te testen zonder de live versie in gevaar te brengen. Elke sandbox heeft eigen app-gegevens en producten, en de testgebruikers die je toevoegt proberen hem uit.
Hoe maak je een sandbox aan?
Vanaf de pagina van de app in het developerportaal. Dit zijn de stappen van TikTok, zodra je een ontwikkelaarsaccount hebt; een organisatie aanmaken of eraan deelnemen wordt aanbevolen, maar is niet verplicht:
- Open Manage apps, selecteer of koppel de app en zet de schakelaar naast de naam op Sandbox.
- Klik op Create Sandbox, geef hem een naam en kloon desgewenst de productieversie of een andere sandbox.
- Bewerk App details, voeg de producten toe die je wilt testen en klik op Apply changes.
- Voeg meer toe met de knop [+] in het linkerpaneel, tot 5 in totaal.
Hoe werken testgebruikers?
Het zijn de TikTok-accounts die de sandbox uitproberen. Kies bij Target users, Add account, log in met het account en ga akkoord met de TikTok Developer Terms of Service. TikTok meldt dat een account dat je zelf bezit de inloggegevens nodig heeft om toegevoegd te worden, en dat nieuwe gebruikers na een vernieuwing tot een uur kunnen duren voordat ze verschijnen. Je kunt er tot 10 toevoegen; zij kunnen vervolgens worden geautoriseerd via Login Kit en de producten die daarvan afhangen, waarvoor een URL-decoder nodig is.
Wat laat de sandboxmodus weg?
Openbaar plaatsen en dataportabiliteit. De sandboxpagina van TikTok vermeldt dat de sandboxmodus geen toegang biedt tot de Content Posting API voor openbare video's of tot de Data Portability API. Ook openbare posts wachten op meer dan alleen de beoordeling: totdat een Content Posting API-client de audit van TikTok doorstaat, plaatst die posts met SELF_ONLY-zichtbaarheid, vanaf privéaccounts, voor maximaal 5 gebruikers binnen 24 uur.
Hoe past de sandbox bij de beoordeling van de app?
Hier komt de demo van een eerste indiening vandaan. De beoordelingsrichtlijnen van TikTok vereisen dat een app die nog nooit is goedgekeurd zijn integratie demonstreert in een sandbox op het Developer Portal. Een sandboxconfiguratie kan vervolgens worden geïmporteerd in een concept in Production mode, wat dat concept overschrijft, en met Revert to Live version keer je terug naar de goedgekeurde configuratie.
Is er een sandbox voor de API for Business?
Er is er één voor advertenties, en die wordt uitgefaseerd. Sandboxaccounts van de API for Business zijn advertentieaccounts, bereikbaar via https://sandbox-ads.tiktok.com/open_api, met nepgegevens in rapportages, één per ontwikkelaarsapp, en beperkt tot één query per seconde, 30 per minuut en 1.000 per dag op elk endpoint. Hun ondersteunde endpoints dekken campagnes, advertentiegroepen, advertenties, uploads van creatives, rapporten, voorwaarden en identiteiten, zonder Accounts API-endpoint onder business/. TikTok faseert ze uit vóór 1 december 2026 en adviseert een testaccount in productie.
Hoe test je de Accounts API zonder sandbox?
Op een echt account dat je zelf bezit en voor tests bewaart. Autoriseer de app met dat account, controleer de scopes van het token met /tt_user/token_info/get/ en probeer te publiceren met de testvideo-URL die TikTok levert voor /business/video/publish/, waarvoor geen URL-verificatie nodig is. De get-started-gids van TikTok verwijst ook naar de Postman-collectie van de API for Business om aanroepen uit te proberen. Testposts tellen mee voor de limieten van dat account: zes per minuut en 15 per dag.
Hoe past easyCoexistence bij testen?
Er valt aan TikTok-kant niets in te stellen. Een TikTok-account dat je zelf bezit koppel je aan easyCoexistence door in te loggen bij TikTok, via de eigen developer-app van easyCoexistence voor de API for Business, zodat er geen sandbox, beoordeling of audit van jouw kant hoeft te wachten. Claude, ChatGPT of de code van je platform publiceert dan, reageert op reacties en leest inzichten van dat account, via dezelfde tools die de accounts van je klanten zullen gebruiken.
Veelgemaakte fouten
- Openbare posttests in een sandbox plannen. De sandboxmodus biedt de Content Posting API voor openbare video's niet.
- Een testgebruiker toevoegen zonder de inloggegevens. TikTok vraagt om de inloggegevens van een account dat je zelf bezit wanneer je het als testgebruiker toevoegt.
- Nieuwe tests starten op sandbox-advertentieaccounts van de API for Business. TikTok faseert ze uit vóór 1 december 2026 en verwijst naar testaccounts in productie.
- Een nog nooit goedgekeurde app indienen zonder sandboxbeelden. De richtlijnen van TikTok vereisen een demonstratie van de integratie in de sandbox voor een eerste beoordeling.
Zo kun je publiceren, reacties en inzichten proberen vanuit Claude, ChatGPT of je eigen code, zonder sandbox of app-beoordeling van jouw kant. US$ 9 tot US$ 0,75 per koppeling per maand, dalend naarmate je meer koppelingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Waarom verschijnen mijn testgebruikers van de TikTok-sandbox niet?
TikTok meldt dat nieuw toegevoegde testgebruikers tot een uur kunnen duren voordat ze na een vernieuwing op de app-pagina verschijnen. Een account dat je zelf bezit vraagt ook om de inloggegevens.
Heeft een TikTok-sandbox een aparte ontwikkelaarsapp nodig?
Nee. Sandboxen leven binnen dezelfde app op developers.tiktok.com, tot 5 stuks, elk met eigen app-gegevens en producten, gescheiden van de live versie.
Tellen testposts op een echt TikTok-account mee voor de limieten?
Ja. Posts die je plaatst tijdens het testen van de Accounts API op een echt account tellen mee voor de limieten van zes per minuut en 15 per dag, net als elke andere post.
Wat moet een demovideo van een TikTok-sandbox laten zien?
De integratie van begin tot eind, met elke gevraagde scope in gebruik. De beoordelingsrichtlijnen van TikTok vragen een nog nooit goedgekeurde app om dat in een sandbox te demonstreren, en een demo die de flow of een scope overslaat is een veelvoorkomende reden voor afwijzing.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op