Hata Yönetimi

TwexAPI HTTP hataları, MCP araç hataları, kredi limitleri ve yazma işlemi yeniden denemelerinden kurtulun.

TwexAPI hataları iki katmanda döner: MCP JSON-RPC hataları (bir araç çalışmadan önce kimlik doğrulama) ve REST HTTP hataları (istek API’ye ulaştıktan sonra). Yeniden denemeler ve insan incelemesi güvenli kalsın diye durum kodlarını, yanıt gövdelerini, imleçleri ve ID’leri koruyun.

REST yanıt zarfı

Başarılı çağrılar şunu döndürür:

{
  "code": 200,
  "msg": "success",
  "data": {}
}

HTTP durumu 2xx değilse, gövdede code alanı olsa bile yanıtı hata olarak değerlendirin. Tam gövdeyi, istek yolunu ve tüketilmiş imleçleri günlüğe kaydedin.

HTTP durum kurtarma

Krediler ve bakiye

Ölçülü okuma ve yazmalar hesap kredilerini harcar. Uzun işlerde birçok sayfa işlerken bakiyeyi başta ve sonda kontrol edin:

curl --request GET \
  --url 'https://api.twexapi.io/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'

403 yanıtları kredi veya erişimden bahsediyorsa:

1. API’ye sürekli istek atan zamanlanmış işleri durdurun.
2. Dashboard’da bakiyeyi doğrulayın.
3. Krediler geri geldikten sonra son kaydedilen imleçten devam edin.

Sayfalama güvenli yeniden denemeler

Arama, takipçiler, zaman çizelgeleri ve DM geçmişi için:

• next_cursor, has_next_page ve task_id değerlerini agent konuşmasının dışında saklayın.
• 429 veya 5xx sonrası aynı imleci yeniden deneyin, sonraki sayfayı değil.
• 400, 404 veya 422 sonrası yeniden denemeden önce ID’leri ve sorgu parametrelerini inceleyin.

Yazma işlemleri

Yazma uç noktaları (tweet, yanıt, beğeni, takip, DM gönderme) şunları gerektirir:

• Geçerli bir TwexAPI API anahtarı
• İstekte kayıtlı bir Twitter cookie’si veya auth_token

Kurtarma kuralları:

TwexAPI ayrı bir yazma işlemi yoklama API’si sunmaz. Yinelenen yan etkilerden önce tweet arama, DM durumu gibi idempotent okuma kontrollerini tercih edin. Cookie kurulumu ve 403 kurtarma:.

MCP hataları

Araç çalışmadan önce kimlik doğrulama başarısız

MCP kimlik doğrulaması başarısız olursa explore ve twexapi_request çalışmaz:

{
  "jsonrpc": "2.0",
  "error": {
    "code": 401,
    "message": "Missing MCP API token"
  }
}

MCP istemcisinde x-api-key veya Authorization: Bearer değerini düzeltin, ardından araç çağrısını yeniden çalıştırın.

twexapi_request üzerinden dönen API hatası

Altta yatan REST çağrısı başarısız olursa araç sonucunu koruyun:

{
  "status_code": 403,
  "endpoint": "get_global_trending_tweets",
  "method": "GET",
  "path": "/twitter/global-trending/tweets",
  "result": {
    "detail": "Credits exhausted or action not allowed."
  }
}

Yukarıdaki HTTP kurtarma tablosunu uygulayın. Modele yeni yol tahmin ettirmeyin — rota değişmiş olabilirse explore’u tekrar çağırın.

SDK ve CLI hataları

Oluşturulan SDK’lar HTTP hatalarını dile özgü istisnalara eşler. Hataları iş sınırında yakalayın, durum kodunu ve yanıt gövdesini günlüğe kaydedin, 429/5xx için yeniden deneme politikalarına yönlendirin.

Python örneği:

import requests

try:
    response = requests.get(
        "https://api.twexapi.io/balance",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        timeout=30,
    )
    response.raise_for_status()
except requests.HTTPError as exc:
    status = exc.response.status_code
    body = exc.response.text
    if status == 429:
        # Back off, preserve cursor, retry later
        ...
    elif status in (400, 404, 422):
        # Fix input; do not retry unchanged
        ...
    raise

Dile özgü desenler için her SDK sayfasına bakın.

Yeniden deneme geri çekilme şablonu

429 ve 5xx için üst sınırlı üstel geri çekilme kullanın:

retry_delays_seconds = [5, 15, 45, 120]

for delay in retry_delays_seconds:
    response = call_twexapi()
    if response.ok:
        break
    if response.status_code in (429, 500, 502, 503, 504):
        time.sleep(delay)
        continue
    break  # 4xx other than 429: stop and fix input

Geri çekilmeyi Rate Limits ile eşleştirin; böylece zamanlanmış işler 429 sonrası hemen tam QPS ile yeniden başlamaz.

Çerçeveye özel notlar

İlgili sayfalar

• Rate Limits
• Authentication
• API Overview
• MCP Tools