Hata Kodları
Bu sayfa TronZap API'si tarafından döndürülebilecek hata kodları hakkında bilgi sağlar.
Hata Yanıt Formatı
Bir hata oluştuğunda, API sıfır olmayan bir hata kodu ve hata mesajı ile yanıt döndürür:
json
{
"code": 1,
"key": "auth",
"request_id": "99d8b507-0bca-4d5a-9542-cc2a2f2e3639",
"error": "Incorrect token or signature"
}Hata Kodu Listesi
| Kod | Key | Açıklama | Çözüm |
|---|---|---|---|
| 0 | — | Başarılı | Hata değil. İstek başarılı oldu. |
| 1 | auth | Kimlik doğrulama hatası | API token'ınızı kontrol edin ve imzanızın doğru hesaplandığından emin olun. |
| 2 | invalid_service_or_params | Geçersiz hizmet veya parametreler | Hizmet adı ve parametrelerin doğru olduğunu kontrol edin. |
| 5 | wallet_not_found | Cüzdan bulunamadı | Cüzdan adresini doğrulayın veya bunun hata olduğunu düşünüyorsanız desteğe başvurun. |
| 6 | insufficient_funds | Yetersiz bakiye | Hesabınıza para ekleyin veya istediğiniz enerji miktarını azaltın. |
| 10 | invalid_tron_address | Geçersiz TRON adresi | TRON adres formatını kontrol edin. Geçerli 34 karakterli TRON adresi olmalıdır. |
| 11 | invalid_energy_amount | Geçersiz enerji miktarı | İstenen enerji miktarının geçerli olduğundan emin olun. |
| 12 | invalid_duration | Geçersiz süre | Süre parametresinin geçerli olduğunu kontrol edin. |
| 50 | invalid_bandwidth_amount | Geçersiz bandwidth miktarı | İstenen bandwidth miktarının geçerli olduğundan emin olun. |
| 20 | subscription_not_found | Abonelik bulunamadı | Abonelik kimliği veya dış kimliğin doğru olduğunu doğrulayın. |
| 21 | cannot_stop_subscription | Abonelik durdurulamıyor | Abonelik limitlerini gözden geçirin; işlem limitini ayarlayın veya bekleyen işlemleri tamamlayın. |
| 24 | address_not_activated | Adres etkinleştirilmemiş | Önce adres etkinleştirme işlemi yaparak adresi etkinleştirin. |
| 25 | address_already_activated | Adres zaten etkinleştirilmiş | Adres zaten etkinleştirilmiş. Herhangi bir işlem yapmanıza gerek yok. |
| 30 | aml_check_not_found | AML kontrolü bulunamadı | AML kontrolünü yeniden çalıştırın veya doğrulama durumunu onaylamak için destekle iletişime geçin. |
| 35 | service_unavailable | Hizmet kullanılamıyor | Hizmet geçici olarak kullanılamıyor. |
| 500 | internal_server_error | Dahili sunucu hatası | Bu hata devam ederse desteğe başvurun. |
Alt Anahtarlar (Sub-keys)
Bazı hatalar, ek bağlam sağlayan daha spesifik bir alt anahtar içerebilir. Alt anahtarlar nokta gösterimi kullanır (örneğin, invalid_tron_address.from_address).
| Temel Anahtar | Sub-key | Açıklama |
|---|---|---|
invalid_tron_address | invalid_tron_address.from_address | Geçersiz gönderen adresi |
invalid_tron_address | invalid_tron_address.to_address | Geçersiz alıcı adresi |
invalid_tron_address | invalid_tron_address.contract_address | Geçersiz sözleşme adresi |
invalid_tron_address | invalid_tron_address.already_subscribed | Adresin zaten aktif bir aboneliği var |
invalid_service_or_params | invalid_service_or_params.network | Desteklenmeyen ağ |
invalid_service_or_params | invalid_service_or_params.address | Geçersiz adres sağlandı |
invalid_service_or_params | invalid_service_or_params.hash | Hash kontrolleri için hash gereklidir |
invalid_service_or_params | invalid_service_or_params.direction | Yön eksik veya geçersiz (hash kontrolleri için zorunlu) |
invalid_service_or_params | invalid_service_or_params.page | Geçersiz sayfa |
invalid_service_or_params | invalid_service_or_params.per_page | Geçersiz per_page |
invalid_service_or_params | invalid_service_or_params.status | Geçersiz durum |
invalid_service_or_params | invalid_service_or_params.id | Geçersiz id / id veya external_id gereklidir |
invalid_service_or_params | invalid_service_or_params.external_id | Geçersiz external_id |
invalid_service_or_params | invalid_service_or_params.address_owner | Adres başka bir kullanıcıya ait |
invalid_service_or_params | invalid_service_or_params.internal_credit | Dahili krediye izin verilmiyor |
invalid_service_or_params | invalid_service_or_params.amount | Miktar aralık dışında |
invalid_service_or_params | invalid_service_or_params.exchange_finalized | Takas tamamlandı |
invalid_service_or_params | invalid_service_or_params.exchange_state | Takas geçersiz durumda |
invalid_energy_amount | invalid_energy_amount.energy_amount | Geçersiz enerji miktarı |
invalid_energy_amount | invalid_energy_amount.bandwidth_amount | Geçersiz bant genişliği miktarı |
invalid_duration | invalid_duration.duration | Süre 1'e eşit olmalıdır (1 saat) |
address_not_activated | address_not_activated.subscription | Abonelik satın almadan önce adres etkinleştirilmelidir |
subscription_not_found | subscription_not_found.transaction | İşlem bulunamadı |
Hataları Ele Alma
API'yi kullanırken, tüm olası hata kodları için hata işleme mantığı uygulamalısınız. İşte bazı öneriler:
Kimlik Doğrulama Hataları (Kod 1)
Kimlik doğrulama hataları API kimlik bilgileriniz veya imza hesaplamanızla ilgili sorunları gösterir. Şunları yapmalısınız:
- API token'ınızın doğru olduğunu doğrulayın
- İmza hesaplama mantığınızı kontrol edin
- API gizli anahtarınızın istemci tarafı kodunda açığa çıkmadığından emin olun
Kaynak Hataları (Kodlar 5, 6, 10, 20)
Kaynak hataları sağlanan kaynaklarla ilgili sorunları gösterir. Şunları yapmalısınız:
- TRON adreslerini API'ye göndermeden önce doğrulayın
- İşlem yapmadan önce hesap bakiyesini kontrol edin
- Durum kontrol ederken işlem kimliklerini doğrulayın
İş Mantığı Hataları (Kodlar 24, 25)
İş mantığı hataları istenen işlemle ilgili sorunları gösterir. Şunları yapmalısınız:
- Enerji satın alma denemesinden önce adres etkinleştirme kontrolü uygulayın
- Zaten etkinleştirilmişse adres etkinleştirmeyi atlayın