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,
"error": "Hata mesajı açıklaması"
}Hata Kodu Listesi
| Kod | Açıklama | Çözüm |
|---|---|---|
| 0 | Başarılı | Hata değil. İstek başarılı oldu. |
| 1 | Kimlik doğrulama hatası | API token'ınızı kontrol edin ve imzanızın doğru hesaplandığından emin olun. |
| 2 | Geçersiz hizmet veya parametreler | Hizmet adı ve parametrelerin doğru olduğunu kontrol edin. |
| 5 | Cüzdan bulunamadı | Cüzdan adresini doğrulayın veya bunun hata olduğunu düşünüyorsanız desteğe başvurun. |
| 6 | Yetersiz bakiye | Hesabınıza para ekleyin veya istediğiniz enerji miktarını azaltın. |
| 10 | Geçersiz TRON adresi | TRON adres formatını kontrol edin. Geçerli 34 karakterli TRON adresi olmalıdır. |
| 11 | Geçersiz enerji miktarı | İstenen enerji miktarının geçerli olduğundan emin olun. |
| 12 | Geçersiz süre | Süre parametresinin geçerli olduğunu kontrol edin. |
| 20 | İşlem bulunamadı | İşlem kimliği veya dış kimliğin doğru olduğunu doğrulayın. |
| 24 | Adres etkinleştirilmemiş | Önce adres etkinleştirme işlemi yaparak adresi etkinleştirin. |
| 25 | Adres zaten etkinleştirilmiş | Adres zaten etkinleştirilmiş. Herhangi bir işlem yapmanıza gerek yok. |
| 500 | Dahili sunucu hatası | Bu hata devam ederse desteğe başvurun. |
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