Hatalar ve yeniden denemeler
API hataları tutarlı bir biçim kullanır. Kod uygulama mantığı içindir; mesaj sorunu açıklar. Kullanıcı girdisini koruyun ve net bir sonraki adım sunun.
Bu sayfada
Tek hata biçimi#
Yanıtlar yığın izi, SQL, token veya tam bir harici sağlayıcı yanıtı içermez. Ham iç günlükleri müşteriye göstermeyin.
{
"error": {
"code": "GATEWAY_NOT_CONNECTED",
"message": "Financial operations are temporarily unavailable. Try later or contact support."
}
}Yaygın hata grupları#
| HTTP | Örnekler | Sonraki adım |
|---|---|---|
| 400 | INVALID_JSON, UNKNOWN_FIELD, INVALID_INPUT | Girdiyi ve izin verilen alanları kontrol edin |
| 401 | AUTH_REQUIRED, SESSION_EXPIRED | Tekrar oturum açın |
| 403 | INVALID_ORIGIN, CSRF_REQUIRED | Origin'i ve güncel oturumu kontrol edin |
| 404 | NOT_FOUND, TICKET_NOT_FOUND | Adresi ve sahipliği kontrol edin |
| 409 | CHALLENGE_UNAVAILABLE | Yeni bir oturum açma başlatın |
| 410 | CHALLENGE_EXPIRED | Yeni bir oturum açma bağlantısı oluşturun |
| 413 | REQUEST_TOO_LARGE | İstek gövdesini küçültün |
| 415 | JSON_REQUIRED | application/json gönderin |
| 429 | RATE_LIMITED | Sıklığı azaltın ve bekleyin |
| 503 | GATEWAY_NOT_CONNECTED, SERVICE_UNAVAILABLE | Kullanılabilirliği kontrol edin veya daha sonra deneyin |
Oran sınırları#
| Eylem | Sınır |
|---|---|
| Oturum açmayı başlat | Hash'lenmiş adres başına dakikada 6 |
| Bir challeng'ı kontrol et | Challenge başına dakikada 90 |
| Bilgi sorusu | D1 ile hash'lenmiş adres başına dakikada 12 |
| Sunucu bağlantısı oluştur | Kullanıcı başına dakikada 20 |
| Satıcı API'si | Anahtar başına dakikada 90 istek |
| Yeni uygulama | Kullanıcı başına günde beş |
| Uygulamayı sürdür / moderatör kararı | Her işlem için kullanıcı başına dakikada 30 |
| AI web sitesi incelemesi | Saatte 30, hizmet genelinde |
| Ödemeyi oku veya ödeme girişiminde bulun | Karma adres başına dakikada 90 |
| Destek talebi oluştur | Kullanıcı başına saatte 6 |
| Bir bildirimi test et | Kullanıcı başına saatte 3 |
| AI üretimi | Varsayılan olarak hizmet genelinde saatte 60 |
Neler yeniden denenebilir#
Geçici bir ağ hatasında, bir gecikme sonrası bir okuma yeniden denenebilir. Bir değişikliği yeniden denemeden önce, orijinal işlemin tamamlanıp tamamlanmadığını kontrol edin; kaybolmuş bir yanıt başarısızlık kanıtı değildir.
Finansal işlemler idempotans ve sunucu durum kontrolü gerektirir. İstemcinin sonuç sayfasına yönlendirilmesi, onayın yerine geçmez.
Bir talebe neler dahil edilmeli#
- Hatadan hemen önceki sayfa ve işlem.
- Zaman, saat dilimi ve görünür hata kodu.
- Varsa, faturanız veya destek talebi referansınız.
- Beklediğiniz sonucun kısa bir açıklaması.