Bandwidth fiyatı hesapla

GET

api

bandwidth

quote

curl --request GET \
  --url https://api.example.com/api/v1/bandwidth/quote

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/bandwidth/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/bandwidth/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/bandwidth/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "volume": 123,
  "duration": "<string>",
  "price_sun": "<string>",
  "rental_trx": "<string>",
  "fixed_fee_trx": "<string>",
  "total_trx": "<string>",
  "personal_price": true
}

Bu miktar ve süredeki bir bandwidth siparişi için tam olarak tahsil edilecek tutarı döner — kiralama ve sabit ücret birlikte, sizin tarifenizle. Fiyat teklifi, siparişi tahsil eden kodun aynısıyla hesaplanır; bu yüzden fiyat değişmediği sürece satın alma tam olarak total_trx tutarına mal olur. Bu uç nokta herkese açıktır — kimlik doğrulama isteğe bağlıdır. Kendi tarifenizi ve sabit ücretinizi almak için API anahtarınızı gönderin; anahtarsız genel fiyat döner.

total_trx değerini kullanıcınıza gösterin ve Bandwidth satın al isteğine max_price_trx olarak gönderin. Fiyat, teklif ile satın alma arasında değişirse satın alma 409 PRICE_CHANGED ile reddedilir ve hiçbir ücret alınmaz — yeniden fiyat teklifi alın ve tekrar deneyin.

Sorgu parametreleri

integer

gerekli

Fiyatlandırılacak bandwidth birimi. 1 ile 100.000 arasında.

string

varsayılan:"1h"

Kiralama süresi: 1h, 1d veya 5m ile 59m arasında tam dakika sayısı — Bandwidth satın al ile aynı değerler.

Başlıklar

string

İsteğe bağlı. Geçerli bir anahtarla yanıt, anlaşmalı tarifenizi ve sabit ücretinizi yansıtır. Anahtarın olmaması, geçersiz veya iptal edilmiş olması hata değildir — personal_price: false ile genel fiyatı alırsınız.

Yanıt

number

Fiyatın hesaplandığı bandwidth miktarı

string

Fiyatın hesaplandığı kiralama süresi

string

1 bandwidth birimi başına SUN cinsinden tarife, gösterim için 0,01’e yuvarlanmış. Dakikalık sürelerde indirim olduğundan tarifeleri kesirli olur ve aşağıdaki tutarlar tam tarifeden hesaplanır — bu yuvarlanmış değeri kendiniz çarpmak yerine total_trx değerini kullanın.

string

Bu miktar ve süre için kiralama bedeli, sabit ücret hariç

string

Sabit ücret; miktar ve süreden bağımsız olarak sipariş başına bir kez alınır. Hesabınızda özel ücret, indirim veya muafiyet varsa burada kendi ücretiniz görünür.

string

Tahsil edilecek tutar: rental_trx + fixed_fee_trx. Bandwidth satın al isteğine max_price_trx olarak gönderin.

boolean

Anlaşmalı tarifeniz uygulandıysa true, fiyat genel fiyatsa false. Bu alanı kontrol edin: aksi halde unutulmuş bir X-API-Key başlığı normal bir yanıt gibi görünür ve müşterilerinize genel fiyatı verirken sizden kendi fiyatınız tahsil edilir.

Örnek

curl "https://api.tronrental.com/v1/bandwidth/quote?volume=1000&duration=5m" \
  -H "X-API-Key: your_api_key"

import requests

resp = requests.get(
    "https://api.tronrental.com/v1/bandwidth/quote",
    params={"volume": 1000, "duration": "5m"},
    headers={"X-API-Key": "your_api_key"},
)
print(resp.json()["total_trx"])

const resp = await fetch(
  "https://api.tronrental.com/v1/bandwidth/quote?volume=1000&duration=5m",
  { headers: { "X-API-Key": "your_api_key" } }
);
const quote = await resp.json();
console.log(quote.total_trx);

Aşağıdaki değerler örnektir: price_sun_1h 400 ve short_max_discount_pct 5. Güncel tarifeler ve indirim Bandwidth fiyatlarını al sayfasındadır.

Response

{
  "volume": 1000,
  "duration": "5m",
  "price_sun": "380.00",
  "rental_trx": "0.380000",
  "fixed_fee_trx": "0.2",
  "total_trx": "0.580000",
  "personal_price": false
}

Fiyat teklifinin içermedikleri

Fiyat teklifi — ve max_price_trx — yalnızca bandwidth siparişini kapsar. Hedef adres zincirde henüz etkinleştirilmemişse Bandwidth satın al adresi etkinleştirir ve etkinleştirme ücretini ayrıca alır (yanıtındaki activation_cost_trx). Bu ücret total_trx tutarına dahil değildir ve max_price_trx ile karşılaştırılmaz.

Başka bir hesap adına işlem: `GET /v1/bandwidth/quote/me`

/bandwidth/quote fiyatı API anahtarının sahibi için hesaplar. Anahtarınız X-Account-Id başlığıyla başka bir hesap adına işlem yapıyorsa satın alma o hesabın tarifesi ve ücretiyle tahsil edilir — fiyat teklifi tahsil edilen tutardan farklı olabilir ve ondan alınan bir max_price_trx değeri 409 PRICE_CHANGED ile reddedilebilir. Bu durumda GET /v1/bandwidth/quote/me kullanın. Aynı sorgu parametrelerini alır ve aynı yanıtı döndürür, ancak kimlik doğrulama zorunludur ve hesap, X-Account-Id dahil, satın almadakiyle tamamen aynı şekilde belirlenir. view kapsamı gerektirir; bu kapsam her anahtarda her zaman vardır.

cURL

curl "https://api.tronrental.com/v1/bandwidth/quote/me?volume=1000&duration=5m" \
  -H "X-API-Key: your_api_key" \
  -H "X-Account-Id: 12345"

Hatalar

Kod	Anlamı
`400 INVALID_VOLUME`	Miktar 1–100.000 aralığının dışında
`400 INVALID_DURATION`	`1h`, `1d` veya `5m` … `59m` dışında bir süre
`401 INVALID_TOKEN`	Yalnızca `/quote/me`: API anahtarı eksik, bilinmiyor veya devre dışı
`403 FORBIDDEN`	Yalnızca `/quote/me`: anahtarınızın `X-Account-Id` içindeki hesaba etkin erişimi yok

/bandwidth/quote üzerinde geçersiz veya iptal edilmiş X-API-Key hata değildir: fiyat genel fiyatla ve personal_price: false ile döner.

Bandwidth fiyatı hesapla

curl --request GET \
  --url https://api.example.com/api/v1/bandwidth/quote

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/bandwidth/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/bandwidth/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/bandwidth/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "volume": 123,
  "duration": "<string>",
  "price_sun": "<string>",
  "rental_trx": "<string>",
  "fixed_fee_trx": "<string>",
  "total_trx": "<string>",
  "personal_price": true
}

Temel API

Bant Genişliği Kiralamaları

Otomatik Dolum

Siparişler

Faturalar

Smart Mode

Transfer Paketleri

Hesap

Webhooks

Bandwidth fiyatı hesapla