Codes d’erreur de l’API Twitter et référence des statuts HTTP

Résolvez les erreurs de l’API Twitter/X dans TwexAPI : HTTP 401, 403, 429 et 5xx, invalid auth_token, tweets en double, limites des messages privés et nouvelles tentatives sûres.

TwexAPI signale les échecs de l’API Twitter/X au moyen de statuts HTTP et, lorsqu’ils sont disponibles, de codes d’erreur renvoyés par X. Un 401 nécessite de corriger les identifiants, un 403 de résoudre un problème d’accès ou de compte, et un 429 d’attendre la réinitialisation de la limite de requêtes. Vérifiez le corps de la réponse avant de réessayer.

Utilisez cette référence pour résoudre les codes d’erreur de l’API Twitter, les erreurs invalid auth_token, les tweets en double et les limites des messages privés. Les chemins des endpoints suivent la référence de l’API actuelle. Pour les erreurs MCP, la reprise de la pagination et les exemples de SDK, consultez Gestion des erreurs.

Les messages et codes renvoyés par X ci-dessous sont des exemples de diagnostic ; la structure des réponses et leur correspondance avec les statuts HTTP peuvent varier selon l’endpoint. Consultez à la fois le schéma de l’endpoint et la réponse réelle.

Trouver la solution à une erreur de l’API Twitter

• HTTP 401 / Invalid auth_token : vérifiez votre clé d’API TwexAPI ainsi que les identifiants de session X utilisés par les endpoints d’écriture. Consultez Authentification.
• HTTP 403 : vérifiez si le message indique un manque de crédits, des publications protégées, des restrictions de compte ou une exigence Premium. Répéter une requête à l’identique ne rétablit pas l’accès.
• HTTP 429 / Too Many Requests : respectez Retry-After ou retry_after et distinguez la limitation des requêtes de la limite quotidienne d’un compte X. Consultez Limites de requêtes.
• HTTP 500 / 502 / 503 : réessayez les lectures qui échouent temporairement en augmentant les délais d’attente jusqu’à un maximum. Vérifiez si une écriture a déjà réussi avant de la répéter.
• Codes X 187, 344 ou 502 : ce sont des codes renvoyés par X, distincts des statuts HTTP. Consultez le tableau des codes Twitter/X et les questions sur les nouvelles tentatives.

Format des réponses d’erreur

Conservez le statut HTTP et le corps JSON complet. Les réponses de TwexAPI peuvent inclure code et msg ; les erreurs de validation des requêtes utilisent detail :

{
  "code": 500,
  "msg": "Internal server error"
}

{
  "detail": [
    {
      "loc": ["body", "cookie"],
      "msg": "Field required",
      "type": "missing"
    }
  ]
}

Si la réponse contient des métadonnées supplémentaires provenant de X, conservez-les :

• error : un message d’erreur, lorsqu’il est fourni. Ne supposez pas que tous les endpoints utilisent ce champ.
• twitter_error_code : un code d’erreur X, lorsqu’il est fourni. Il est indépendant du statut HTTP ; le code X 502, par exemple, correspond à une limite des messages privés.
• retry_after : le nombre de secondes à attendre, lorsqu’il est fourni. Respectez également l’en-tête HTTP Retry-After.

N’exigez pas la présence des champs facultatifs et ne fondez pas vos décisions uniquement sur le texte exact du message. Un statut HTTP autre que 2xx indique un échec, même si le corps contient un code différent.

Erreurs courantes pour tous les endpoints

Vérifiez ces conditions pour toute requête. Les messages exacts peuvent varier.

Statuts HTTP de l’API Twitter

Codes d’erreur de l’API Twitter/X

Lorsqu’un code X figure dans la réponse, utilisez les significations suivantes. Il s’agit de codes X, pas de statuts HTTP, et tous les endpoints n’exposent pas twitter_error_code.

Lecture des tweets et recherche

S’applique à POST /twitter/{screen_name}/timeline/page, /twitter/tweets-replies/page et /twitter/advanced_search/page.

Publication et interactions

Créer un tweet

POST /twitter/tweets/create

Utilisez tweet_content, le champ facultatif reply_tweet_id et vos identifiants X dans cookie. Consultez Créer un tweet ou une réponse.

J’aime / Retweet / Signet

POST /twitter/tweets/{tweet_id}/like · /twitter/tweets/{tweet_id}/retweet · /twitter/tweets/{tweet_id}/bookmark

DELETE /twitter/tweets/{tweet_id}/like · /twitter/tweets/{tweet_id}/retweet · /twitter/tweets/{tweet_id}/bookmark

Supprimer un tweet

POST /twitter/tweets/delete-batch

Fournissez target_id pour supprimer un seul tweet. Si vous l’omettez, vous sélectionnez la suppression en masse ; conservez les champs de la requête d’origine lors de la reprise après une erreur.

S’abonner / Se désabonner

POST /twitter/user/follow · DELETE /twitter/user/follow

Modifier le profil / L’avatar / La bannière

POST /twitter/profile

Utilisez profile_image et profile_banner pour les URL des images, et cookie pour les identifiants X.

Pièces jointes multimédias

Joignez des fichiers multimédias lors de la création de tweets ou de l’envoi de messages privés ; la référence actuelle ne contient pas de route distincte de téléversement de médias. Pour la création de tweets, media_urls accepte jusqu’à quatre images, un GIF ou une vidéo. Ne combinez pas un GIF ou une vidéo avec d’autres médias. Corrigez les URL inaccessibles, les formats non pris en charge ou les tailles de fichier refusées avant de réessayer. Suivez le schéma de l’endpoint pour les noms des champs et les contraintes.

Messages privés

POST /v3/twitter/send-dm · /v3/twitter/dm-history · /v3/twitter/conversations

Pour vérifier les permissions, utilisez POST /v2/dm/status. Consultez Envoyer un message privé.

Lecture des données

POST /v2/tweet/detail · /twitter/tweets/lookup · /twitter/users/by_ids · /v3/twitter/users/followers · /v3/twitter/users/following · /twitter/tweets/thread_by_id · /twitter/tweets/{tweet_id}/replies/page

GET /twitter/{screen_name}/about · /twitter/search-user/{keyword}/{target_count}

Articles

POST /x/article · GET /x/article/{tweet_id}/markdown

Pour les écritures : POST /x/articles/draft · PUT /x/articles/{article_id}/cover · /x/articles/{article_id}/title · /x/articles/{article_id}/content · POST /x/articles/{article_id}/publish ou /x/articles/publish.

L’exigence Premium ci-dessous s’applique à la publication d’articles. Privilégiez le parcours de création d’article étape par étape pour conserver article_id et réessayer uniquement l’étape qui a échoué.

Guide des nouvelles tentatives

Conseil : Utilisez des délais d’attente croissants, plafonnés, avec une variation aléatoire pour 429 et les erreurs 5xx temporaires. Pour 400/401/403/404/409/422, corrigez d’abord les données d’entrée, les identifiants ou l’accès du compte.

Questions sur les erreurs de l’API Twitter et les nouvelles tentatives

Pourquoi l’API Twitter renvoie-t-elle 401 ou invalid auth_token ?

HTTP 401 peut indiquer que votre clé d’API TwexAPI est absente ou invalide. Pour les endpoints d’écriture, Invalid auth_token ou le code X 32 peuvent aussi indiquer que la session X a expiré. Corrigez l’en-tête Bearer ou renouvelez les identifiants X fournis dans cookie avant de réessayer.

Quelle est la différence entre les erreurs 403 et 429 de l’API Twitter ?

HTTP 403 indique un problème d’accès, comme des crédits insuffisants, du contenu privé, un compte restreint ou une action réservée à Premium. HTTP 429 indique une limite de requêtes ou de compte. Corrigez la cause d’un 403 ; après un 429, attendez la réinitialisation de la limite indiquée.

Comment résoudre l’erreur 429 Too Many Requests de l’API Twitter ?

Respectez le délai indiqué par Retry-After ou retry_after lorsqu’il est fourni, puis reprenez avec moins de requêtes simultanées et des délais d’attente croissants, plafonnés. Une limite quotidienne de tweets ou de messages privés nécessite d’attendre sa réinitialisation, pas seulement de faire une courte pause. Conservez le curseur de la page qui a échoué lorsque vous réessayez une lecture.

Que signifie le code d’erreur Twitter 187 ?

Le code d’erreur X 187 signifie que le contenu du tweet est en double. Vérifiez si l’écriture précédente a déjà créé la publication. Si vous souhaitez publier un contenu différent, modifiez tweet_content au lieu de répéter la même requête.

Que signifie le code d’erreur Twitter 344 ?

Le code d’erreur X 344 indique une restriction temporaire de publication liée au réseau ou à l’IP. Augmentez le délai d’attente, vérifiez tout proxy que vous avez fourni et consultez le fil du compte avant de réessayer l’écriture. Il s’agit d’un code d’erreur X, pas d’un statut HTTP.

Faut-il réessayer les erreurs 500, 502 ou 503 de l’API Twitter ?

Réessayez les lectures qui échouent temporairement avec des délais d’attente croissants, plafonnés, et une variation aléatoire. Après une écriture qui dépasse le délai d’attente ou renvoie 5xx, consultez d’abord le fil du compte, l’historique des messages privés ou l’état de l’interaction. Une réponse d’échec ne prouve pas que l’écriture n’a jamais été appliquée.

Faut-il réessayer après une erreur de validation 422 de TwexAPI ?

Ne réessayez pas avec les mêmes données d’entrée. TwexAPI utilise HTTP 422 pour les erreurs de validation des requêtes. Consultez detail pour identifier le champ en échec, son emplacement et le type d’erreur, puis corrigez la requête conformément au schéma de l’endpoint.

Le code d’erreur Twitter 502 est-il identique à HTTP 502 ?

Non. Le code d’erreur X 502 correspond à une limite quotidienne de demandes de message privé et peut accompagner HTTP 429. HTTP 502 indique un échec de réponse du service en amont. Lisez le statut HTTP et twitter_error_code, lorsqu’il est fourni, avant de choisir une politique de nouvelle tentative.

Pages connexes

• Gestion des erreurs — MCP, SDK et reprise de la pagination
• Authentification — clés d’API et identifiants de session X
• Limites de requêtes — délais d’attente et débit
• Présentation de l’API — référence actuelle des endpoints