Ana içeriğe atla
POST
Bant Genişliği Kuralı Oluştur

Bant Genişliği Kuralı Oluştur

Bir adres için bir Otomatik Dolum kuralı oluşturur. Bir sonraki kontrolden itibaren adresteki kullanılabilir bant genişliği threshold_bandwidth değerinin altına her düştüğünde, seçilen duration süresi için add_volume kadar bant genişliği satın alır ve bakiyenizden ücret alırız. Kontrollerin, maliyetin ve durumların nasıl işlediği için genel bakışa bakın. İstek yalnızca kuralı oluşturur — kendisi hiçbir şey satın almaz. buy_bandwidth kapsamını gerektirir. Önce bir dolumun fiyatını görmek için Bant Genişliği Dolum Fiyatı uç noktasını kullanın.
Kullanılabilir bant genişliği, adresin bir işlemin bedelini ödemek için kullanabileceği her şeyi sayar: günlük ücretsiz 600 ile stake edilmiş veya devredilmiş bant genişliği. 600 veya daha düşük bir eşik, adres bu ücretsiz payı harcayana kadar yalnızca onunla karşılanır.

İstek gövdesi

string
gerekli
Kaynağı sürekli sağlanacak TRON adresi (T… formatı, 34 karakter). Sözleşme adresleri reddedilir.
number
gerekli
Adresteki kullanılabilir bant genişliği bu değerin altına düştüğünde satın alınır. 1 ile 1.000.000 arasında.
number
gerekli
Dolum başına satın alınacak bant genişliği. 350 ile 100.000 arasında. Bu değeri threshold_bandwidth ile aynı veya ondan yüksek tutun — bkz. genel bakıştaki uyarı.
string
varsayılan:"1h"
Her dolumun kiralama süresi: "1h" veya "1d".
string
Kurala kendi verdiğiniz ad, en fazla 100 karakter. İsteğe bağlı.

Yanıt

Yeni kural — Bant Genişliği Kurallarını Listele ile aynı alanlar — ve adresin şu anki durumuna dair iki alan:
number | null
Kural oluşturulduğu anda adreste kullanılabilir olan bant genişliği, ücretsiz bant genişliği dahil. Okunamadıysa null; kural her durumda oluşturulur.
boolean
current_bandwidth zaten eşiğin altındaysa true; bu durumda bir sonraki kontrol — genellikle bir dakika içinde — satın alır. Adreste yeterli bant genişliği varsa veya seviye okunamadıysa false.

Örnek

Response

Hatalar

Doğrulama hatası, çerçevenin kendi biçiminde ve detail bir dizi olarak gelir:
Zaman aşımından sonra oluşturma isteğini yeniden denemek güvenlidir. İlk istek başarılı olduysa yeniden deneme ikinci bir kural oluşturmaz, 409 AUTOREFILL_ADDRESS_TAKEN döndürür; kuralın id değerini almak için kurallarınızı listeleyin.