Hata Kodları

Bir API çağrısı başarısız olduğunda yanıt, sıfırdan farklı bir code ve okunabilir bir error mesajı içerir.

Hata yanıtı formatı

{
  "code": 60,
  "key": "address_from",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "error": "Invalid TRON address"
}

Alan	Açıklama
code	Sıfırdan farklı tam sayı hata kodu.
key	Uygulanabilir olduğunda hataya neden olan alanın adı. Aksi hâlde boş dize.
request_id	İsteğin benzersiz tanımlayıcısı. Destek ekibiyle iletişimde ekleyin.
error	Hatanın okunabilir açıklaması.

HTTP durum kodları

HTTP Durumu	Anlamı
200	İstek başarılı (code: 0) veya uygulama düzeyinde hata (code: non-zero).
429	Hız sınırı aşıldı — /v1/orders* uç noktalarında saniyede 1 istek/IP.
422	İşlenemeyen istek — doğrulama başarısız (gövdede de code: non-zero olarak döner).
500	Dahili sunucu hatası — bizim tarafımızda beklenmedik bir arıza.

Yaygın hata durumları

Durum	Olası neden
Geçersiz address_from veya address_to	Geçerli bir TRON adresi değil (T ile başlamalı, 34 karakter).
duration 1'e eşit değil	Yalnızca 1 saatlik kiralama desteklenir.
energy ve bandwidth ikisi de 0	En az bir kaynak talep edilmelidir.
energy veya bandwidth sınır dışı	İstenen miktar bu proje için izin verilen minimum veya maksimum değerin dışında.
Yinelenen aktif sipariş	Aynı address_from + address_to çifti için new durumunda aktif bir sipariş zaten mevcut.
order_id bulunamadı	check veya cancel'a iletilen order_id mevcut değil.
Hız sınırı aşıldı	Aynı IP'den saniyede 1'den fazla istek gönderiyorsunuz. Geri çekilin ve yeniden deneyin.
referral_code çok uzun	referral_code dizesi 64 karakteri aşıyor.

Hataları ele alma

1. Başarıyı garanti etmediğinden, yanıt gövdesindeki code değerini her zaman kontrol edin (HTTP 200).
2. Hata ayıklama için her hatayla birlikte request_id değerini kaydedin.
3. HTTP 429 için yeniden denemeden önce üstel geri çekilme uygulayın.
4. duplicate active order hatası için yeni bir sipariş oluşturmak yerine mevcut siparişi almak üzere Sipariş Kontrolü kullanın.