Hatalar | Proxynet Docs

Hata zarfı

{
  "error": {
    "code": "not_found",
    "message": "Order not found.",
    "request_id": "83955522c09ff2d1"
  }
}

Tanımsız bir yol da aynı zarfla JSON 404 not_found döner; HTML sayfası dönmez.

Kodlar

HTTP	code	Ne zaman
401	`unauthorized`	Token yok, biçimi bozuk ya da geçersiz.
403	`insufficient_scope`	Token'da bu ucun istediği yetki yok.
403	`tier_required`	İstenen özellik planınızda yok (ör. kendi kullanıcı adınızı seçmek).
403	`forbidden`	Bu işleme izin verilmiyor.
404	`not_found`	Kaynak bulunamadı ya da süresi dolduğu için gizli.
404	`api_disabled`	API erişimi kapalı.
405	`method_not_allowed`	Bu uç bu HTTP yöntemini desteklemiyor. Desteklenen yöntemler Allow başlığındadır.
400	`invalid_request`	Geçersiz alan, bilinmeyen alan ya da parametre, yanlış tipe özel alan.
402	`insufficient_balance`	Bakiye bu işleme yetmiyor.
409	`conflict`	Durum çakışması: yenilenemez hizmet, işlenmekte olan idempotent istek, alınmış kullanıcı adı.
429	`rate_limited`	İstek limiti aşıldı.
502 / 503	`service_unavailable`	Sağlayıcıya ya da log deposuna ulaşılamadı; tekrar deneyin.
500 / 502	`internal_error`	Beklenmeyen hata; request_id ile destekle iletişime geçin.

details

Hatanın makine-okunur ayrıntısı varsa details alanında döner: hatalı alan (field), stok (available), minimum adet (min_required), bakiye (balance), izin verilen üst değer (max), hatanın sebebi (reason) gibi. Örneğin hizmet tipi bakımdaysa service_unavailable ile birliktereason: maintenance gelir.

402 insufficient_balance

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient balance for this operation.",
    "request_id": "5f1c0a9e7b2d4c61",
    "details": { "field": "balance", "balance": 3.2, "min_required": 12.5 }
  }
}

request_id

request_id değerini loglayın; destek ekibi sunucu kaydında o kimlikle arama yapabilir.