Temel API
Bandwidth satın al
TRON adresi için bandwidth satın alın
POST
Bandwidth satın al
Bandwidth satın al
Belirtilen TRON adresine bandwidth devreder. Maliyet hesap bakiyenizden düşülür.İstek gövdesi
string
gerekli
Hedef TRON adresi (T… formatı, 34 karakter)
number
gerekli
Devredilecek bandwidth miktarı (min 1, maks 100.000)
string
gerekli
Kiralama süresi, şunlardan biri:
"1h"— 1 saat"1d"— 24 saat"5m"…"59m"— 5 ile 59 arasında herhangi bir tam dakika sayısı, saatlik tarifeden indirimli (bkz. Fiyatlandırma)
m olarak yazın: "5m", "30m". "05m", "5M",
"60m" veya "90m" 400 INVALID_DURATION ile reddedilir: bir saat "1h" olarak yazılır ve
"1h" ile "1d" arasında başka bir süre yoktur. "24h" veya sayısal saat değerleri kullanmayın; "1d" kullanın.string
İsteğe bağlı. Bu sipariş için ödemeyi kabul ettiğiniz en yüksek tutar (TRX) — kiralama ve sabit
ücret birlikte. Sipariş bundan pahalıya gelecekse
409 PRICE_CHANGED ile reddedilir ve hiçbir
ücret alınmaz. Bandwidth fiyatı hesapla yanıtındaki
total_trx değerini gönderin. "0.58" gibi ondalık bir dize (JSON sayısı da kabul edilir), 0’dan
büyük. Bu alan olmadan sipariş, eskisi gibi güncel fiyattan satın alınır.Başlıklar
string
İsteğe bağlı, en fazla 64 karakter. Aynı anahtar ve aynı gövdeyle yapılan tekrar, yeniden satın
almak yerine ilk siparişi döndürür. Başarılı bir siparişten sonra aynı anahtar farklı bir gövdeyle —
farklı bir
max_price_trx dahil — 422 IDEMPOTENCY_KEY_REUSED döndürür. 409 PRICE_CHANGED veya
402 INSUFFICIENT_BALANCE gibi hiçbir ücret alınmayan bir retten sonra anahtar yeniden kullanılabilir
hâle gelir: aynı anahtarla ve yeni fiyatla tekrar deneyin.Anahtarla yapılan ilk istek hâlâ işlenirken yapılan bir tekrar 409 IDEMPOTENT_REQUEST_IN_PROGRESS
döndürür: birkaç saniye bekleyin ve aynı anahtarla tekrar deneyin. Anahtar kontrol edilemezse istek,
hiçbir şey satın alınmadan 503 IDEMPOTENCY_UNAVAILABLE ile reddedilir: aynı anahtarla tekrar
deneyin. Anahtar 24 saat saklanır; bu sürenin ardından yeni bir satın alma başlatır.
Tekrar denemeler
Enerji Satın Al → Zaman aşımları ve tekrar denemeler bölümünde anlatıldığı gibi çalışır.Yanıt
number
Benzersiz sipariş kimliği
string
Sipariş durumu:
filled, failed veya submitted_unknown — delegasyon yayınlandı ancak henüz bir
blokta onaylanmadı; birkaç dakika içinde filled olur ya da tam iadeyle failed olur:
Get Order ile kontrol edin.string | null
Delegasyon yayınlandıktan sonraki on-chain işlem kimliği
string
Bakiyeden düşülen siparişin toplam maliyeti (TRX) — kiralama ve sabit ücret
string | null
Kiralanan bandwidth geri alındığında ISO 8601 zaman damgası
string
target_address henüz etkinleştirilmemişse zincirde etkinleştirilmesi için price_trx dışında
ayrıca alınan tutar. Zaten aktif bir adres için "0".Fiyatlandırma
1h ve 1d: fiyat = volume × price_sun / 1,000,000 + sabit ücret (hesabınızın kendi ücreti yoksa 0,2 TRX); burada price_sun,
Bandwidth fiyatlarını al yanıtındaki price_sun_1h veya
price_sun_1d değeridir ya da hesabınızın anlaşmalı bir tarifesi varsa o tarifedir.
5m … 59m: indirimli saatlik tarife (price_sun_1h veya anlaşmalı saatlik tarifeniz). İndirim
5 dakikada en büyüktür ve 59 dakikada doğrusal olarak sıfıra iner:
short_max_discount_pct değeri
Bandwidth fiyatlarını al sayfasındadır.
Bunların hiçbirini hesaplamanız gerekmez: Bandwidth fiyatı hesapla
miktarınız, süreniz ve hesabınız için tam tutarı döndürür.
Fiyatı gösterin, sonra o fiyattan satın alın
X-API-KeyanahtarınızlaGET /v1/bandwidth/quoteçağırın vetotal_trxdeğerini kullanıcınıza gösterin.max_price_trxdeğerini butotal_trxolarak ayarlayıpPOST /v1/bandwidth/buyçağırın.
total_trx tutarına mal olur. Arada fiyat değiştiyse satın alma, hiçbir ücret
alınmadan 409 PRICE_CHANGED ile reddedilir: yeni bir fiyat teklifi alın, gösterin ve tekrar
deneyin — kullanıyorsanız aynı Idempotency-Key ile.
Örnek
Response
Örnek: fiyat teklifi alın, sonra 5 dakikalığına satın alın
Aşağıdaki değerler örnektir:
price_sun_1h 400 ve short_max_discount_pct 5.Response
max_price_trx değerinden pahalıysa — örneğin "0.57" gönderdiniz ve sipariş 0,58 TRX
tutuyorsa — hiçbir ücret alınmaz ve yanıt şöyledir:
409 PRICE_CHANGED
Hatalar
0, negatif bir sayı veya sayı olmayan bir
max_price_trx değeri, çerçevenin kendi biçiminde bir
422 doğrulama hatasıdır. Diğer kodlar Hatalar sayfasında listelenmiştir.