Cotação de recarga de largura de banda

GET

api

bandwidth

auto-refill

quote

Cotação de recarga de largura de banda

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

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/bandwidth/auto-refill/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/bandwidth/auto-refill/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/auto-refill/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/auto-refill/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

{
  "add_volume": 123,
  "duration": "<string>",
  "estimated_cost_per_refill_trx": "<string>"
}

Cotação de recarga de largura de banda

Retorna quanto custa para a sua conta uma recarga de add_volume de largura de banda por duration: o preço que uma regra com essas configurações paga por recarga, taxa fixa incluída. Nada é criado nem cobrado. Exige o escopo view. O preço depende de como você faz a chamada. Chamado com uma chave de API, é o preço de uma regra criada com essa chave de API; a partir do site, o preço de uma regra criada no site. É o preço no momento da requisição e não inclui a ativação de um endereço que ainda não existe na blockchain — a primeira recarga acrescenta esse valor.

Parâmetros de consulta

number

obrigatório

Largura de banda por recarga. De 350 a 100.000, o mesmo intervalo aceito ao criar uma regra.

string

padrão:"1h"

Duração do aluguel de cada recarga: 1h ou 1d.

Resposta

number

O volume que você consultou

string

A duração que você consultou — 1h ou 1d

string

Preço total de uma recarga para a sua conta, taxa fixa incluída

Exemplo

curl "https://api.tronrental.com/v1/bandwidth/auto-refill/quote?add_volume=5000&duration=1d" \
  -H "X-API-Key: your_api_key"

import requests

resp = requests.get(
    "https://api.tronrental.com/v1/bandwidth/auto-refill/quote",
    headers={"X-API-Key": "your_api_key"},
    params={"add_volume": 5000, "duration": "1d"},
)
print(resp.json())

const resp = await fetch(
  "https://api.tronrental.com/v1/bandwidth/auto-refill/quote?add_volume=5000&duration=1d",
  { headers: { "X-API-Key": "your_api_key" } },
);
console.log(await resp.json());

Response

{
  "add_volume": 5000,
  "duration": "1d",
  "estimated_cost_per_refill_trx": "0.500000"
}

Erros

Status	Código	Quando
`403`	`FORBIDDEN`	A chave de API não tem o escopo `view`
`422`	—	`add_volume` está ausente ou fora de 350 – 100.000, ou `duration` não é `1h` nem `1d`
`503`	`TEMPORARILY_UNAVAILABLE`	Não foi possível obter o preço agora — tente novamente após os segundos indicados em `Retry-After`

{
  "detail": {
    "error": {
      "code": "TEMPORARILY_UNAVAILABLE",
      "message": "Please retry shortly"
    }
  }
}

Um erro de validação vem no formato do framework, com detail como array:

{
  "detail": [
    {
      "type": "literal_error",
      "loc": ["query", "duration"],
      "msg": "Input should be '1h' or '1d'",
      "input": "2h",
      "ctx": {"expected": "'1h' or '1d'"}
    }
  ]
}

Cotação de recarga de largura de banda

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

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/bandwidth/auto-refill/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/bandwidth/auto-refill/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/auto-refill/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/auto-refill/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

{
  "add_volume": 123,
  "duration": "<string>",
  "estimated_cost_per_refill_trx": "<string>"
}

API Principal

Aluguéis de largura de banda

Recarga automática

Pedidos

Faturas

Smart Mode

Pacotes de transferência

Conta

Webhooks

Cotação de recarga de largura de banda

Cotação de recarga de largura de banda

Parâmetros de consulta

Resposta

Exemplo

Erros

​Cotação de recarga de largura de banda

​Parâmetros de consulta

​Resposta

​Exemplo

​Erros

Cotação de recarga de largura de banda

Parâmetros de consulta

Resposta

Exemplo

Erros