Błąd TikTok 40002: błąd parametru w żądaniu
Błąd TikTok 40002 to błąd parametru: pole w żądaniu jest brakujące, ma zły format, nie jest obsługiwane albo jest niezgodne z innym polem. Odpowiedź wskazuje problem w komunikacie, na przykład brak wymaganego pola. Popraw to pole według dokumentacji endpointu, na przykład business_id, post_info lub max_count w Accounts API, i wyślij żądanie ponownie.
easyCoexistence dodaje business_id do każdego wywołania TikToka, jakie wykonuje dla Claude, ChatGPT albo twojego własnego kodu, i sprawdza post przed wysłaniem: wideo albo od 1 do 35 obrazów, z linkami HTTPS, a zdjęcia PNG są odrzucane, bo TikTok przyjmuje tylko JPEG lub WebP.
Kod zwrotny TikToka dla błędu parametru, ze szczegółami w komunikacie odpowiedzi.
Status przykładowej odpowiedzi TikToka 40002. Awarię pokazuje pole code, a nie status HTTP.
Znaki liczone w UTF-16, jakie może zawierać podpis wideo przez Accounts API, w tym do 30 wzmianek.
Liczba komentarzy na stronę, jaką /business/comment/list/ przyjmuje w max_count; domyślnie 20.
Najdalej w przeszłość może sięgać start_date przy odczycie statystyk konta przez /business/get/.
Co oznacza błąd 40002?
Jeden lub więcej parametrów nie pasuje do tego, co endpoint przyjmuje. Dodatek TikToka z kodami zwrotnymi wymienia 40002 jako błąd parametru i odsyła do komunikatu błędu po szczegóły. Wymienione przyczyny to: brakujące pola wymagane, niepoprawny format, nieobsługiwane pola lub wartości, pola wzajemnie niezgodne, nieprawidłowa dokładność danych oraz nieprawidłowy numer.
Jak czytać odpowiedź?
Zacznij od komunikatu, który wskazuje pole. Przykład TikToka, poniżej, wraca z HTTP 200 i komunikatem „Missing required field(s): account_id.” Inny przykład w dodatku brzmi „Time format should be %Y-%m-%dT%H:%M.” Zachowaj też request_id, bo wytyczne TikToka proszą o niego w zgłoszeniach problemów.
HTTPS/1.1 200 OK
{
"code": 40002,
"message": "Missing required field(s): account_id.",
"request_id": "2022110918305001025108614416C7CC00"
}Które reguły Accounts API warto sprawdzić?
Każdy endpoint w swojej dokumentacji ustala własne. Oto reguły stojące za wywołaniami, które połączenie wykonuje, by publikować, pracować z komentarzami i odczytywać statystyki:
- Każde wywołanie:
business_id, ustawiony naopen_id, który wrócił wraz z tokenem dostępu konta. - Posty wideo:
video_urlipost_infosą wymagane,post_infonawet gdy jest pusty; podpisy mają do 2 200 znaków. - Posty ze zdjęciami: do 35 adresów URL obrazów w
photo_images,privacy_leveldozwolony dla konta i tytuł do 90 znaków. - Komentarze:
video_idtoitem_idposta z /business/video/list/,max_countprzyjmuje od 1 do 30, acomment_idsnajwyżej 30. - Odpowiedzi: tekst do 1 200 znaków albo obraz w jego miejsce.
- Statystyki: daty zapisane jak 2021-06-01, w UTC, sięgające najwyżej 60 dni wstecz.
Jak to naprawić?
Znajdź w dokumentacji endpointu pole wskazane w komunikacie, popraw je i wyślij żądanie ponownie. Błąd opisuje samo żądanie, więc wysłanie go bez zmian zwróci ten sam kod. Dla wartości zależnych od konta, na przykład poziomów prywatności albo tego, czy komentarze można włączyć, odczytaj dozwolone opcje z /business/video/settings/ przed publikacją.
A problemy z plikiem multimedialnym?
TikTok zgłasza je już po wywołaniu. Endpointy publikacji zwracają share_id zadania publikacji, podczas gdy TikTok pobiera plik. Gdy plik łamie regułę, /business/publish/status/ pokazuje FAILED z przyczyną, na przykład file_format_check_failed, frame_rate_check_failed albo picture_size_check_failed. TikTok oznacza te przyczyny jako nienadające się do ponowienia, więc sam plik musi się zmienić.
Typowe błędy
- Ponowne wysłanie tego samego żądania. 40002 opisuje parametry, więc nic się nie zmieni, dopóki nie poprawisz pola wskazanego w komunikacie.
- Zapisywanie parametrów tablicowych jako zwykły tekst. Pola takie jak fields wysyła się jako tablice JSON, jak w przykładzie TikToka ["display_name", "profile_image"].
- Używanie jednego ustawienia prywatności dla każdego konta. Opcje różnią się dla kont publicznych i prywatnych, więc najpierw odczytaj privacy_level_options z /business/video/settings/.
- Ustawianie disable_comment na false na koncie, na którym komentarze są wyłączone. Gdy comment_disabled ma wartość true, TikTok przyjmuje tylko true.
Gdy TikTok mimo to odpowie 40002, narzędzie zwraca jego kod i komunikat, dzięki czemu twoja AI może poprawić pole i spróbować ponownie. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, mniej przy każdym kolejnym połączeniu. Pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czym jest błąd parametru w API TikToka?
To kod zwrotny 40002: pole w żądaniu jest brakujące, źle sformatowane, nieobsługiwane albo niezgodne z innym polem, a komunikat mówi, które.
Dlaczego TikTok wysyła błąd 40002 z HTTP 200?
Kody zwrotne TikToka mają pierwszeństwo przed statusem HTTP, więc odpowiedź 200, której kod nie jest równy 0, to nadal nieudane wywołanie.
Czy ponowić błąd 40002?
Dopiero po zmianie żądania. Parametry powodują błąd, więc popraw pole wskazane w komunikacie, zanim wyślesz je ponownie.
Gdzie widać problemy z plikiem wideo?
W statusie publikacji. Gdy TikTok pobierze multimedia, plik łamiący jego reguły sprawia, że /business/publish/status/ pokazuje FAILED z przyczyną wskazującą niezaliczony test.
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