Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

TikTok-julkaisut epäonnistuivat: spam_risk_too_many_posts, picture_size_check_failed ja muut syyt

TikTok ilmoittaa epäonnistuneen julkaisun syyn kentässä reason API for Business -rajapinnan status-endpointissa ja kentässä fail_reason Content Posting API:ssa. Tarkistusvirheet, kuten picture_size_check_failed, tarkoittavat, että tiedosto rikkoo muotosääntöä ja se on vaihdettava. video_pull_failed tarkoittaa, ettei TikTok ehtinyt ladata tiedostoa tunnin sisällä. spam_risk_too_many_posts tarkoittaa, että API-julkaisuja on liikaa 24 tunnin aikana. Virhe, joka on merkitty internal, voidaan yksinkertaisesti yrittää uudelleen.

easyCoexistence seuraa jokaista julkaisemaansa TikTok-julkaisua, kunnes TikTok saa sen valmiiksi tai epäonnistuttaa sen, Claudelle, ChatGPT:lle tai omalle alustallesi: epäonnistuminen saapuu TikTokin syyn kanssa sähköpostilla, Julkaisut-näkymään ja post.failed-tapahtumana, valmiina uudelleenyritykseen.

reason

Kenttä /business/publish/status/ palautuu vain, kun tila on FAILED, ja sen arvoja ovat esimerkiksi frame_rate_check_failed.

fail_reason

Content Posting API:n nimi samalle kentälle, /v2/post/publish/status/fetch/ -vastauksissa.

1 hour

Latausaikaraja, jonka jälkeen TikTok epäonnistuttaa julkaisun virheellä video_pull_failed tai photo_pull_failed.

24 hours

Ikkuna, johon spam_risk_too_many_posts liittyy; TikTok ehdottaa, että tämä julkaisu julkaistaan sen sijaan mobiilisovelluksesta.

3 hours

Useimmiten easyCoexistence lähettää omistajalle sähköpostin epäonnistuneista julkaisuista yhdellä kanavalla; julkaisu odottaa kohdassa Vaatii huomiota.

Mistä TikTok kertoo, miksi julkaisu epäonnistui?

Julkaisukutsun jälkeen, joka vain käynnistää tehtävän: sen koodi 0 tarkoittaa, että TikTok hyväksyi pyynnön, ei sitä, että julkaisu menee läpi. GET /business/publish/status/ palauttaa sitten tilan FAILED ja syyn reason, ja sovellus, joka on tilannut julkaisun webhookit, saa tapahtuman post.publish.failed samalla syyllä ja publish_id:llä. Content Posting API:n /v2/post/publish/status/fetch/ palauttaa kentän nimellä fail_reason:

A failed post in /business/publish/status/, from TikTok's example
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "reason": "frame_rate_check_failed",
    "status": "FAILED"
  }
}

Mitä kukin virhesyy tarkoittaa ja mikä sen korjaa?

TikTokin syyt sellaisina kuin sen julkaisutapahtumien viiteasiakirja ne kuvaa, vierellään korjaus, johon kukin osoittaa. Neljä ensimmäistä ovat tarkistuksia, jotka TikTok tekee tiedostolle sen latauksen jälkeen, ja kaikki ne on merkitty ei uudelleenyritettäviksi. TikTokin virhetaulukko antaa yhä 60 sekuntia pisimmäksi videoksi duration_check_failed-virheelle, kun videoendpoint dokumentoi 600 sekuntia tai tilin oman max_video_post_duration_sec-arvon:

What TikTok foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing again if the post is still wanted

Mitkä virheet voidaan yrittää uudelleen?

Ne, jotka johtuvat latauksesta tai itse TikTokista. Loput tarvitsevat toisen tiedoston tai kuvatekstin, tauon tai eivät mitään:

  • Yritä sellaisenaan uudelleen: internal sekä video_pull_failed tai photo_pull_failed, kun URL on julkinen ja tarpeeksi nopea.
  • Yritä uudelleen uudella tiedostolla: file_format_check_failed, duration_check_failed, frame_rate_check_failed ja picture_size_check_failed.
  • Yritä uudelleen uudella kuvatekstillä: spam_risk_text.
  • Odota tai julkaise TikTok-sovelluksesta: spam_risk_too_many_posts.
  • Älä yritä uudelleen: auth_removed ja spam_risk, kuten TikTok neuvoo, tai spam_risk_user_banned_from_posting.

Miten Content Posting API:n virheet eroavat?

Samat syyt, eri kenttä ja endpoint, sekä kieltäytymiset, jotka tulevat ennen käsittelyn alkua. /v2/post/publish/status/fetch/ palauttaa fail_reason-kentän, sallii 30 pyyntöä minuutissa käyttäjätunnusta kohden ja lisää neuvon olla yrittämättä uudelleen spam_risk_user_banned_from_posting- ja spam_risk_text-virheissä. Osa kieltäytymisistä tulee sen sijaan alustuskutsuun HTTP-koodilla 403:

  • spam_risk_too_many_posts: tekijä ylitti rajapinnan päivittäisen julkaisurajan.
  • unaudited_client_can_only_post_to_private_accounts: tarkastamaton sovellus yritti julkaista julkiselle tilille.
  • url_ownership_unverified: PULL_FROM_URL verkkotunnuksesta tai etuliitteestä, jota sovellus ei ole vahvistanut.
  • privacy_level_option_mismatch: privacy_level puuttuu tai on tekijän vaihtoehtojen ulkopuolella.
  • reached_active_user_cap: sovellus saavutti päivittäisen kiintiönsä aktiivisille julkaisijoille.

Mikä epäonnistuu ennen kuin TikTok näkee julkaisun?

Sen, minkä easyCoexistence voi havaita ensin, omalla viestillään TikTokin syyn sijaan. Ajoitetun julkaisun media kopioidaan ajoituksen yhteydessä, ja linkki, joka palauttaa verkkosivun, 404-virheen, väärän tyypin tai tiedoston, joka on yli 30 MB kuvana tai yli 1 GB videona, hylätään jo silloin. Kuvalinkit, jotka päättyvät .png, .gif, .bmp, .heic, .avif tai .svg, hylätään ennen kuin mitään lähetetään. Kanava, joka pitää yhdistää uudelleen julkaisuhetkellä, epäonnistuu tilalla reconnect, ja kanavan poistaminen peruuttaa sen ajoitetut julkaisut.

Miten easyCoexistence raportoi epäonnistuneen TikTok-julkaisun?

Julkaisujonon kautta, joka seuraa jokaista TikTok-julkaisua julkaisukutsun jälkeen ja tarkistaa /business/publish/status/-tilan noin 20 sekunnin välein, kunnes PUBLISH_COMPLETE. FAILED-tila epäonnistuttaa julkaisun, ja sen virheilmoitus nimeää TikTokin syyn sulkeissa, esimerkiksi frame_rate_check_failed, ja jokaisella epäonnistumisella on failure_kind:

  • refused: TikTok vastasi kielteisesti, kuten FAILED-tilassa ja sen syyllä.
  • uncertain: julkaisukutsusta ei saatu selvää vastausta tai TikTok ei vahvistanut 2 tunnin kuluessa, joten julkaisu saattaa olla jo näkyvissä (may_be_published).
  • reconnect: TikTok hylkäsi tilin tokenin, ja tili tarvitsee uuden kirjautumisen.
  • internal: easyCoexistence epäonnistui ennen julkaisun luovuttamista, joten mitään ei lähtenyt.

Miten löydät ja yrität epäonnistunutta julkaisua uudelleen?

Omistaja saa sähköpostin taustalla löydetystä epäonnistumisesta, enintään yhden kanavaa kohden 3 tunnin välein, ja alustan tapahtumien URL vastaanottaa post.failed-tapahtuman. Julkaisu näkyy Julkaisut-näkymässä kohdassa Vaatii huomiota painikkeineen Yritä uudelleen, Yhdistä uudelleen ja Hylkää, ja list_scheduled_posts palauttaa sen Claudelle tai ChatGPT:lle. retry_scheduled_post julkaisee sen uudelleen heti, tiedostoista, jotka säilytetään 7 päivää epäonnistumisen jälkeen. Kun may_be_published on tosi, tarkista ensin list_social_posts ja anna confirm vain, jos julkaisu puuttuu. Julkaisu, joka tarvitsee uuden tiedoston tai kuvatekstin, ajoitetaan sen sijaan uudelleen.

Failed posts through MCP
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 }

Yleiset virheet

  • Tarkistusvirheen yrittäminen uudelleen samalla tiedostolla. TikTok merkitsee muodon, keston, kuvataajuuden ja kuvankoon virheet ei uudelleenyritettäviksi.
  • spam_risk_too_many_posts-virheen yrittäminen heti. TikTok laskee API-julkaisut 24 tunnin ajalta ja ehdottaa julkaisemista mobiilisovelluksesta.
  • Julkaisun yrittäminen uudelleen katsomatta, kun se on merkitty may_be_published. TikTok on saattanut julkaista sen; tarkista tilin uusimmat julkaisut, tai se menee kahdesti perille.
  • fail_reasonin etsiminen API for Business -rajapinnasta. Sen status-endpoint nimeää kentän reason; fail_reason kuuluu Content Posting API:lle.
Näin teet tämän EasyCoexistencen avulla

US$ 9:stä US$ 0.75:een kuukaudessa per yhteys, hinta laskee lisäyhteyksien myötä, ja ensimmäiset 3 päivää ovat ilmaisessa kokeilussa.

Usein kysytyt kysymykset

Mitä picture_size_check_failed tarkoittaa TikTokissa?

TikTok latasi julkaisun ja huomasi kuvan olevan alle vähimmäiskoon 360 pikseliä korkeudessa ja leveydessä. Tarvitaan suurempi tiedosto, koska TikTok merkitsee virheen ei uudelleenyritettäväksi.

Mikä on video_pull_failed?

TikTok ei voinut ladata videota sen URL:stä tai ei ehtinyt tunnin aikarajan sisällä. Tarkista, että URL on julkinen eikä kaistanleveys ole rajoitettu, ja yritä sitten uudelleen.

Kuinka kauan spam_risk_too_many_posts kestää?

TikTok laskee rajapinnan kautta tehdyt julkaisut viimeisen 24 tunnin ajalta, noin 15 päivässä tiliä kohden, ja ehdottaa julkaisemista TikTok-mobiilisovelluksesta siihen asti.

Yrittääkö easyCoexistence epäonnistunutta TikTok-julkaisua uudelleen itsekseen?

Ei sen jälkeen, kun TikTok ilmoittaa FAILED: julkaisu odottaa kohdassa Vaatii huomiota, omistajalle lähetetään sähköposti, ja Yritä uudelleen tai retry_scheduled_post lähettää sen uudelleen.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu