Dokümanlar

Hatalar

Standart HTTP durum kodları. Her hata gövdesi aynı şekilde JSON: `type` ve `message` içeren üst-seviye bir `error` objesi, artı opsiyonel ekstralar (ör. 402 için `balance_usd_micros`). Eski `detail` anahtarı geri-uyumluluk için korunuyor.

#Yanıt şekli

http

HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "type": "error",
  "error": {
    "type": "insufficient_credit",
    "message": "Pay-per-token balance depleted.",
    "balance_usd_micros": 0,
    "topup_url": "/tenant/billing/topup"
  },
  "detail": { "error": "insufficient_credit", "balance_usd_micros": 0, "topup_url": "/tenant/billing/topup" }
}

#Anlamı

Kod	Hata türü	Anlamı
400	invalid_json	İstek gövdesi geçerli JSON değildi.
400	invalid_request	Şema doğrulaması başarısız — eksik zorunlu alan, yanlış tür veya bilinmeyen alan.
401	unauthorized	Eksik, bozuk veya iptal edilmiş API anahtarı.
402	insufficient_credit	Token başına bakiye sıfır. Gövde `balance_usd_micros` ve `topup_url` içerir.
402	no_subscription	Aktif planı olmayan abonelik-modlu anahtar. Açmak için panelden bir plan seçin.
403	wrong_metering_mode	Sadece token-başına rotası abonelik anahtarıyla vuruldu. pay_per_token anahtarı oluşturun ya da araç-ayarlı rotayı kullanın.
429	quota_exceeded	Abonelik 24s penceresi tükendi. Sıfırlama zamanı `x-powapi-quota-reset-at` (unix saniye) header'ında.
500	internal_error	Beklenmeyen sunucu tarafı hatası. Backoff ile tekrar deneyin; kalıcıysa status.powapi.io'a bakın.
502	upstream_error	Tüm yönlendirme adayları başarısız. 30 saniye içinde tekrar deneyin — cascade ondan sonra yeniden karılır.