Twitter API Hata Kodları ve HTTP Durumları Referansı

TwexAPI'de Twitter/X API hatalarını giderin: HTTP 401, 403, 429 ve 5xx, geçersiz auth_token, yinelenen tweetler, DM sınırları ve güvenli yeniden denemeler.

TwexAPI, Twitter/X API hatalarını HTTP durum kodları ve mevcut olduğunda X’ten gelen hata kodları aracılığıyla bildirir. 401, kimlik bilgilerinin düzeltilmesini; 403, erişim veya hesap sorununun giderilmesini; 429 ise hız sınırı nedeniyle beklenmesini gerektirir. Yeniden denemeden önce yanıt gövdesini kontrol edin.

Twitter API hata kodları, invalid auth_token, yinelenen tweetler ve DM sınırlarıyla ilgili sorunları gidermek için bu referansı kullanın. Uç nokta yolları güncel API referansına uygundur. MCP hataları, sayfalama hatalarından kurtarma ve SDK örnekleri için Hata Yönetimi sayfasına bakın.

Aşağıdaki mesajlar ve X’ten gelen kodlar sorun giderme örnekleridir; yanıt yapıları ve HTTP durumlarıyla eşleştirmeler uç noktaya göre değişebilir. Uç nokta şemasını ve gerçek yanıtı birlikte değerlendirin.

Twitter API hatası için doğru çözümü bulun

• HTTP 401 / Invalid auth_token: Hem TwexAPI API anahtarınızı hem de yazma uç noktalarında kullanılan X oturumunun kimlik bilgilerini kontrol edin. Kimlik Doğrulama sayfasına bakın.
• HTTP 403: Mesajda yetersiz kredi, korumalı gönderi, hesap kısıtlaması veya Premium gereksinimi olup olmadığını inceleyin. Aynı isteği değiştirmeden tekrarlamak erişimi geri kazandırmaz.
• HTTP 429 / Too Many Requests: Retry-After veya retry_after değerine uyun; istek hızının kısıtlanmasıyla X hesabının günlük sınırını ayırt edin. Hız Sınırları sayfasına bakın.
• HTTP 500 / 502 / 503: Geçici okuma hatalarında bekleme süresini belirli bir üst sınıra kadar artırarak yeniden deneyin. Bir yazma işlemini tekrarlamadan önce işlemin zaten başarılı olup olmadığını kontrol edin.
• X kodları 187, 344 veya 502: Bunlar X’ten gelen kodlardır ve HTTP durum kodlarından ayrıdır. Twitter/X kod tablosuna ve yeniden deneme sorularına bakın.

Hata yanıtı biçimi

HTTP durumunu ve JSON gövdesinin tamamını saklayın. TwexAPI yanıtları code ve msg içerebilir; istek doğrulama hataları detail kullanır:

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

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

Yanıt, X’ten gelen ek meta veriler içeriyorsa bunları da saklayın:

• error: Sağlandığında hata mesajını içerir. Her uç noktanın bu alanı kullandığını varsaymayın.
• twitter_error_code: Sağlandığında X hata kodunu içerir. HTTP durumundan ayrıdır; örneğin X kodu 502, bir DM sınırını belirtir.
• retry_after: Sağlandığında beklenecek saniye sayısını belirtir. HTTP Retry-After başlığına da uyun.

İsteğe bağlı alanların mutlaka bulunmasını beklemeyin veya yalnızca mesajın tam metnine göre işlem yapmayın. Gövdede farklı bir code bulunsa bile 2xx dışındaki bir HTTP durumu hatadır.

Yaygın hatalar (tüm uç noktalar)

Her istekte bu koşulları kontrol edin. Mesajların tam metni değişebilir.

Twitter API HTTP durum kodları

Twitter/X API hata kodları

Yanıtta X’ten gelen bir kod bulunduğunda aşağıdaki anlamları kullanın. Bunlar X kodlarıdır, HTTP durumları değildir; her uç nokta twitter_error_code alanını sunmaz.

Tweet okuma ve arama

POST /twitter/{screen_name}/timeline/page, /twitter/tweets-replies/page ve /twitter/advanced_search/page için geçerlidir.

Gönderi oluşturma ve etkileşim

Tweet oluşturma

POST /twitter/tweets/create

tweet_content, isteğe bağlı reply_tweet_id ve cookie içinde X kimlik bilgilerinizi kullanın. Tweet veya Yanıt Oluşturma sayfasına bakın.

Beğenme / Retweet / Yer imi

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

Tweet silme

POST /twitter/tweets/delete-batch

Tek bir tweeti silmek için target_id sağlayın. Bu alanı belirtmezseniz toplu silme seçilir; hatalardan kurtarma sırasında özgün istek alanlarını koruyun.

Takip etme / Takibi bırakma

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

Profil / Avatar / Kapak görseli güncelleme

POST /twitter/profile

Görsel URL’leri için profile_image ve profile_banner, X kimlik bilgileri için cookie kullanın.

Medya ekleri

Tweet oluştururken veya DM gönderirken medya ekleyin; güncel referansta ayrı bir medya yükleme yolu yoktur. Tweet oluştururken media_urls, en fazla dört görsel, bir GIF veya bir videoyu destekler. GIF/video ile diğer medyaları bir arada kullanmayın. Yeniden denemeden önce erişilemeyen URL’leri, desteklenmeyen biçimleri veya reddedilen dosya boyutlarını düzeltin. Alan adları ve kısıtlamalar için uç nokta şemasına uyun.

Direkt mesajlar

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

İzin kontrolleri için POST /v2/dm/status kullanın. DM Gönderme sayfasına bakın.

Veri okuma

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}

Makaleler

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

Yazma işlemleri için: 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 veya /x/articles/publish.

Aşağıdaki Premium gereksinimi makale yayımlama için geçerlidir. article_id değerini koruyabilmek ve yalnızca başarısız olan adımı yeniden deneyebilmek için adım adım makale akışını tercih edin.

Yeniden deneme rehberi

İpucu: 429 ve geçici 5xx hatalarında bekleme süresini belirli bir üst sınıra kadar artırın ve süreye rastgele sapma (jitter) ekleyin. 400/401/403/404/409/422 için önce girdiyi, kimlik bilgilerini veya hesap erişimini düzeltin.

Twitter API hataları ve yeniden deneme soruları

Twitter API neden 401 veya invalid auth_token döndürür?

HTTP 401, TwexAPI API anahtarınızın eksik veya geçersiz olduğunu belirtebilir. Yazma uç noktalarında Invalid auth_token veya X kodu 32, X oturumunun süresinin dolduğunu da belirtebilir. Yeniden denemeden önce Bearer başlığını düzeltin veya cookie içinde sağladığınız X kimlik bilgilerini yenileyin.

Twitter API 403 ve 429 hataları arasındaki fark nedir?

HTTP 403, yetersiz kredi, gizli içerik, kısıtlı hesap veya yalnızca Premium’a açık işlem gibi bir erişim sorununu belirtir. HTTP 429, bir istek veya hesap sınırını belirtir. 403 hatasının nedenini giderin; 429 sonrasında belirtilen sınırın sıfırlanmasını bekleyin.

Twitter API 429 Too Many Requests hatasını nasıl gideririm?

Sağlanmışsa Retry-After veya retry_after kadar bekleyin; ardından eşzamanlı istek sayısını azaltarak ve bekleme süresini belirli bir üst sınıra kadar artırarak devam edin. Günlük tweet veya DM sınırı, yalnızca kısa bir gecikme değil, sıfırlanma süresinin dolmasını gerektirir. Okuma işlemini yeniden denerken başarısız olan sayfanın cursor değerini koruyun.

Twitter hata kodu 187 ne anlama gelir?

X hata kodu 187, yinelenen tweet içeriği anlamına gelir. Önceki yazma işleminin gönderiyi zaten oluşturup oluşturmadığını kontrol edin. Farklı bir gönderi yayımlamak istiyorsanız aynı isteği tekrarlamak yerine tweet_content değerini değiştirin.

Twitter hata kodu 344 ne anlama gelir?

X hata kodu 344, ağ veya IP ile ilişkili geçici bir gönderi oluşturma kısıtlamasını belirtir. Bekleme süresini artırın, sağladığınız proxy’yi kontrol edin ve yazma işlemini yeniden denemeden önce hesabın zaman akışını inceleyin. Bu bir X hata kodudur; HTTP durum kodu değildir.

Twitter API 500, 502 veya 503 hatalarında yeniden denemeli miyim?

Geçici okuma hatalarında bekleme süresini belirli bir üst sınıra kadar artırarak ve rastgele sapma (jitter) ekleyerek yeniden deneyin. Bir yazma işlemi zaman aşımına uğrarsa veya 5xx döndürürse önce zaman akışını, DM geçmişini veya etkileşim durumunu inceleyin. Hata yanıtı, yazma işleminin hiç uygulanmadığını kanıtlamaz.

TwexAPI 422 doğrulama hatasında yeniden denemeli miyim?

Aynı girdiyi yeniden göndermeyin. TwexAPI, istek doğrulama hataları için HTTP 422 kullanır. Hatalı alanı, konumunu ve türünü bulmak için detail alanını inceleyin, ardından isteği uç nokta şemasına göre düzeltin.

Twitter hata kodu 502 ile HTTP 502 aynı mı?

Hayır. X hata kodu 502, günlük DM isteği sınırını belirtir ve HTTP 429 ile birlikte gelebilir. HTTP 502, üst hizmetten gelen yanıtta bir hata olduğunu belirtir. Yeniden deneme politikasını seçmeden önce hem HTTP durumunu hem de sağlanmışsa twitter_error_code alanını okuyun.

İlgili sayfalar

• Hata Yönetimi — MCP, SDK’lar ve sayfalama hatalarından kurtarma
• Kimlik Doğrulama — API anahtarları ve X oturumu kimlik bilgileri
• Hız Sınırları — bekleme süresini artırma ve istek işleme hızı
• API Genel Bakışı — güncel uç nokta referansı