Testowanie TikTok API przed zatwierdzeniem: sandbox
Tryb sandbox w TikTok for Developers pozwala wypróbować integrację aplikacji przed wysłaniem jej do przeglądu: do 5 sandboxów, każdy to konfiguracja oddzielona od aplikacji produkcyjnej, testowana przez do 10 użytkowników testowych, których dodajesz z ich własnym logowaniem. Nie obejmuje Content Posting API dla publicznych filmów ani Data Portability API.
easyCoexistence łączy profil TikTok, który posiadasz, przez zalogowanie na TikTok, poprzez własną aplikację dewelopera API for Business, więc możesz wypróbować publikowanie, komentarze i statystyki z Claude, ChatGPT lub własnego kodu bez sandboxa i przeglądu aplikacji.
Maksymalna liczba sandboxów, jaką TikTok for Developers pozwala utworzyć, do testowania integracji bez wysyłania aplikacji do przeglądu.
Maksymalna liczba użytkowników testowych. Dodanie własnego użytkownika wymaga podania danych logowania.
Gdy TikTok wycofuje sandboxy API for Business, zaleca deweloperom utworzenie testowego profilu w środowisku produkcyjnym.
Limit na endpoint w sandboxach API for Business, oprócz jednego zapytania na sekundę i 1,000 dziennie.
Czas, po jakim nowo dodani użytkownicy testowi mogą pojawić się na stronie aplikacji po odświeżeniu.
Czym jest tryb sandbox w TikTok?
Ograniczone środowisko w developers.tiktok.com, w którym integracja aplikacji działa przed przeglądem. TikTok opisuje je jako sposób wypróbowania integracji bez wysyłania aplikacji oraz testowania konfiguracji bez narażania wersji produkcyjnej. Każdy sandbox ma własne dane aplikacji i produkty, a dodani użytkownicy testowi wypróbowują go.
Jak utworzyć sandbox?
Ze strony aplikacji w portalu deweloperskim. Kroki TikTok, po zarejestrowaniu się jako deweloper; utworzenie lub dołączenie do organizacji jest zalecane, lecz nie wymagane:
- Otwórz Manage apps, wybierz lub połącz aplikację i przełącz przełącznik obok jej nazwy na Sandbox.
- Kliknij Create Sandbox, nadaj nazwę i opcjonalnie sklonuj wersję produkcyjną lub inny sandbox.
- Edytuj App details, dodaj produkty do testów, a następnie kliknij Apply changes.
- Dodaj kolejne przyciskiem [+] w lewym panelu, do 5 łącznie.
Jak działają użytkownicy testowi?
To profile TikTok, które wypróbowują sandbox. W ustawieniach sandboxa, w sekcji Target users, wybierz Dodaj profil, zaloguj się na ten profil i zaakceptuj Warunki korzystania z usługi TikTok Developer. TikTok zaznacza, że profil, który posiadasz, wymaga danych logowania, aby go dodać, a nowi użytkownicy mogą pojawić się nawet po godzinie od odświeżenia. Można dodać do 10 użytkowników, którzy następnie mogą zostać autoryzowani przez Login Kit i zależne od niego produkty; do tego kroku potrzebny jest dekoder URL.
Czego tryb sandbox nie obejmuje?
Publicznego publikowania i przenoszenia danych. Strona TikTok o sandboxie stwierdza, że tryb ten nie daje dostępu do Content Posting API dla publicznych filmów ani do Data Portability API. Publiczne posty czekają też na coś więcej niż przegląd: dopóki aplikacja korzystająca z Content Posting API nie przejdzie audytu TikTok, publikuje w widoczności SELF_ONLY, z prywatnych profili, dla maksymalnie 5 użytkowników w ciągu 24 godzin.
Jak sandbox wpisuje się w przegląd aplikacji?
Stąd pochodzi demo pierwszego zgłoszenia. Wytyczne TikTok do przeglądu wymagają, by aplikacja, która nigdy nie była zatwierdzona, zademonstrowała integrację w sandboxie w Developer Portal. Konfiguracja sandboxa może następnie zostać zaimportowana do wersji roboczej w trybie Production mode, co nadpisuje tę wersję roboczą, a Revert to Live version przywraca zatwierdzoną konfigurację.
Czy na API for Business jest sandbox?
Jest jeden, dla reklam, i jest wycofywany. Sandboxy API for Business to profile reklamowe, dostępne pod adresem https://sandbox-ads.tiktok.com/open_api, z symulowanymi danymi raportowania, po jednym na aplikację dewelopera, z limitem jednego zapytania na sekundę, 30 na minutę i 1,000 dziennie na każdy endpoint. Obsługiwane endpointy obejmują kampanie, grupy reklam, reklamy, przesyłanie kreacji, raporty, warunki oraz tożsamości, bez endpointu Accounts API pod business/. TikTok wycofuje je do 1 grudnia 2026 i zaleca profil testowy w środowisku produkcyjnym.
Jak testować Accounts API bez sandboxa?
Na prawdziwym profilu, który posiadasz i zachowujesz do testów. Autoryzuj aplikację tym profilem, sprawdź zakresy tokenu przez /tt_user/token_info/get/ i spróbuj publikować testowym adresem URL wideo, który TikTok udostępnia dla /business/video/publish/, a który nie wymaga weryfikacji adresu URL. Przewodnik Get started od TikTok wskazuje też kolekcję Postman API for Business do wypróbowania wywołań. Testowe posty wliczają się w limity tego profilu: sześć na minutę i 15 dziennie.
Jak easyCoexistence wpisuje się w testowanie?
Bez żadnej konfiguracji po stronie TikTok. Profil TikTok, który posiadasz, łączy się z easyCoexistence przez zalogowanie na TikTok, poprzez własną aplikację dewelopera API for Business easyCoexistence, więc nie ma sandboxa, przeglądu ani audytu, na które trzeba czekać. Claude, ChatGPT lub kod twojej platformy następnie publikuje, odpowiada na komentarze i odczytuje statystyki na tym profilu przez te same narzędzia, z których będą korzystać profile twoich klientów.
Typowe błędy
- Planowanie testów publicznych postów w sandboxie. Tryb sandbox nie daje dostępu do Content Posting API dla publicznych filmów.
- Dodawanie użytkownika testowego bez jego danych logowania. TikTok wymaga danych logowania profilu, który posiadasz, przy dodawaniu go jako użytkownika testowego.
- Rozpoczynanie nowych testów na sandboxach profili reklamowych API for Business. TikTok wycofuje je do 1 grudnia 2026 i wskazuje profile testowe w środowisku produkcyjnym.
- Zgłaszanie aplikacji, która nigdy nie była zatwierdzona, bez nagrania z sandboxa. Wytyczne TikTok wymagają demonstracji integracji w sandboxie przy pierwszym przeglądzie.
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Dlaczego moi użytkownicy testowi sandboxa TikTok się nie pokazują?
TikTok zaznacza, że nowo dodani użytkownicy testowi mogą pojawić się na stronie aplikacji nawet po godzinie od odświeżenia. Dodanie własnego profilu wymaga też podania jego danych logowania.
Czy sandbox TikTok wymaga osobnej aplikacji dewelopera?
Nie. Sandboxy działają w obrębie tej samej aplikacji w developers.tiktok.com, do 5 z nich, każdy z własnymi danymi aplikacji i produktami, oddzielony od wersji produkcyjnej.
Czy posty testowe na prawdziwym profilu TikTok wliczają się w jego limity?
Tak. Posty publikowane podczas testów Accounts API na prawdziwym profilu wliczają się w jego limity: sześć na minutę i 15 dziennie, jak każdy inny post.
Co powinno pokazywać wideo demo sandboxa TikTok?
Integrację od początku do końca, z użyciem każdego żądanego zakresu. Wytyczne TikTok do przeglądu wymagają od aplikacji, która nigdy nie była zatwierdzona, demonstracji w sandboxie, a demo pomijające przepływ lub zakres to częsta przyczyna odrzucenia.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w