TikTok-publicatiefouten: spam_risk_too_many_posts, picture_size_check_failed en andere foutredenen
TikTok geeft de oorzaak van een mislukte post aan in reason, op het statuseindpunt van de API for Business, of in fail_reason bij de Content Posting API. Controlefouten zoals picture_size_check_failed betekenen dat het bestand een formaatregel overtreedt en gewijzigd moet worden; video_pull_failed betekent dat TikTok het binnen een uur niet kon downloaden; spam_risk_too_many_posts betekent te veel API-posts binnen 24 uur. Een fout met de markering internal kan gewoon opnieuw worden geprobeerd.
easyCoexistence volgt elke TikTok-post die het publiceert tot TikTok hem voltooit of laat mislukken, voor Claude, ChatGPT of je eigen platform: een fout komt met de reden van TikTok per e-mail, op het scherm Posts en als post.failed-event binnen, klaar om opnieuw te proberen.
Veld /business/publish/status/ wordt alleen teruggegeven als de status FAILED is, met waarden zoals frame_rate_check_failed.
De naam van hetzelfde veld in de Content Posting API, in de antwoorden van /v2/post/publish/status/fetch/.
Downloadtime-out waarna TikTok een post met video_pull_failed of photo_pull_failed laat mislukken.
Tijdvenster achter spam_risk_too_many_posts; TikTok raadt aan die post via de mobiele app van TikTok te publiceren.
Meestal stuurt easyCoexistence een eigenaar een e-mail over mislukte posts op één kanaal; de post wacht onder Actie vereist.
Waar meldt TikTok waarom een post is mislukt?
Na de publicatieaanroep, die alleen de taak start: code 0 betekent dat TikTok de aanvraag heeft aanvaard, niet dat de post live gaat. GET /business/publish/status/ geeft dan FAILED met reason, en een app die is geabonneerd op publicatie-webhooks ontvangt post.publish.failed met dezelfde reden en de publish_id. Het eindpunt /v2/post/publish/status/fetch/ van de Content Posting API geeft het veld terug als fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Wat betekent elke foutreden en wat lost die op?
De redenen van TikTok, zoals de referentie voor publicatie-events ze beschrijft, naast de oplossing waarnaar elke reden verwijst. De eerste vier zijn controles die TikTok op het bestand uitvoert nadat het is gedownload, en ze zijn allemaal als niet-herhaalbaar gemarkeerd. De foutentabel van TikTok noemt nog steeds 60 seconden als langste video voor duration_check_failed, terwijl het video-eindpunt 600 documenteert, of de eigen max_video_post_duration_sec van het account:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
Welke fouten kunnen opnieuw worden geprobeerd?
Die door de download of door TikTok zelf zijn veroorzaakt. De rest heeft een ander bestand of een ander bijschrift nodig, een pauze, of niets:
- Opnieuw proberen zoals het is: internal, en
video_pull_failedofphoto_pull_failedzodra de URL openbaar en snel genoeg is. - Opnieuw proberen met een nieuw bestand:
file_format_check_failed,duration_check_failed,frame_rate_check_failedenpicture_size_check_failed. - Opnieuw proberen met een nieuw bijschrift:
spam_risk_text. - Wachten, of publiceren via de TikTok-app:
spam_risk_too_many_posts. - Niet opnieuw proberen:
auth_removedenspam_risk, zoals TikTok adviseert, ofspam_risk_user_banned_from_posting.
Hoe verschillen de fouten van de Content Posting API?
Dezelfde redenen, een ander veld en eindpunt, en weigeringen die al vóór de verwerking plaatsvinden. /v2/post/publish/status/fetch/ geeft fail_reason terug, staat 30 verzoeken per minuut per gebruikerstoken toe en voegt advies om niet opnieuw te proberen toe voor spam_risk_user_banned_from_posting en spam_risk_text. Enkele weigeringen komen in plaats daarvan bij de init-aanroep, met HTTP 403:
spam_risk_too_many_posts: de creator heeft het dagelijkse postplafond van de API bereikt.unaudited_client_can_only_post_to_private_accounts: een niet-geauditeerde app probeerde te posten voor een openbaar account.url_ownership_unverified:PULL_FROM_URLvanaf een domein of voorvoegsel dat de app niet heeft geverifieerd.privacy_level_option_mismatch: eenprivacy_leveldie ontbreekt of buiten de opties van de creator valt.reached_active_user_cap: de app heeft het dagelijkse quotum van actieve publicatiegebruikers bereikt.
Wat mislukt voordat TikTok de post ziet?
Wat easyCoexistence als eerste kan opvangen, met een eigen bericht in plaats van een TikTok-reden. De media van een geplande post wordt gekopieerd op het moment van plannen, en een link die een webpagina, een 404, het verkeerde type of een bestand groter dan 30 MB voor een afbeelding of 1 GB voor een video teruggeeft, wordt dan geweigerd. Fotolinks die eindigen op .png, .gif, .bmp, .heic, .avif of .svg worden geweigerd voordat er iets wordt verzonden, een kanaal dat op het moment van posten opnieuw moet worden verbonden mislukt als reconnect, en het verwijderen van een kanaal annuleert de geplande posts.
Hoe meldt easyCoexistence een mislukte TikTok-post?
Via de publicatiewachtrij, die elke TikTok-post volgt na de publicatieaanroep en ongeveer elke 20 seconden /business/publish/status/ controleert tot PUBLISH_COMPLETE. Een FAILED-status laat de post mislukken, waarvan de fout de reden van TikTok tussen haakjes noemt, zoals frame_rate_check_failed, en elke fout krijgt een failure_kind:
- refused: TikTok heeft nee gezegd, zoals bij een FAILED-status met de reden ervan.
- uncertain: de publicatieaanroep kreeg geen duidelijk antwoord, of TikTok gaf binnen 2 uur geen bevestiging, dus de post kan live staan (
may_be_published). - reconnect: TikTok heeft het token van het account geweigerd, en het account moet opnieuw worden aangemeld.
- internal: easyCoexistence is mislukt voordat de post werd overgedragen, dus er is niets verzonden.
Hoe vind en probeer je een mislukte post opnieuw?
De eigenaar krijgt een e-mail voor een fout die op de achtergrond is gevonden, hooguit één per kanaal om de 3 uur, en het eindpunt voor events van een platform ontvangt post.failed. De post staat onder Actie vereist op het scherm Posts, met Opnieuw proberen, Opnieuw verbinden en Negeren, en list_scheduled_posts geeft hem terug aan Claude of ChatGPT. retry_scheduled_post publiceert hem opnieuw, nu, vanuit bestanden die 7 dagen na een fout worden bewaard; als may_be_published waar is, controleer dan eerst list_social_posts en geef confirm alleen mee als de post ontbreekt. Een post die een nieuw bestand of bijschrift nodig heeft, wordt in plaats daarvan opnieuw ingepland.
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }Veelgemaakte fouten
- Een controlefout opnieuw proberen met hetzelfde bestand. TikTok markeert de fouten voor formaat, duur, framesnelheid en beeldformaat als niet-herhaalbaar.
- spam_risk_too_many_posts direct opnieuw proberen. TikTok telt API-posts over 24 uur en raadt aan te publiceren via de mobiele app.
- Een post die als may_be_published staat, opnieuw proberen zonder te kijken. TikTok kan hem al hebben gepubliceerd; controleer de laatste posts van het account, anders gaat hij twee keer uit.
- fail_reason zoeken op de API for Business. Het statuseindpunt daar noemt het veld reason; fail_reason hoort bij de Content Posting API.
Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Wat betekent picture_size_check_failed bij TikTok?
TikTok heeft de post gedownload en vond de afbeelding kleiner dan het minimum van 360 pixels in hoogte en breedte; er is een groter bestand nodig, want TikTok markeert de fout als niet-herhaalbaar.
Wat is video_pull_failed?
TikTok kon de video niet downloaden van zijn URL, of niet binnen de time-out van één uur. Controleer of de URL openbaar is en niet bandbreedtebeperkt, en probeer daarna opnieuw.
Hoe lang geldt spam_risk_too_many_posts?
TikTok telt de posts die via de API zijn gemaakt over de afgelopen 24 uur, ongeveer 15 per dag per account, en raadt intussen aan te publiceren via de mobiele TikTok-app.
Probeert easyCoexistence een mislukte TikTok-post zelf opnieuw?
Niet nadat TikTok FAILED heeft gemeld: de post wacht onder Actie vereist en de eigenaar krijgt een e-mail, en Opnieuw proberen of retry_scheduled_post stuurt hem opnieuw.
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