Cotización de recarga de ancho de banda

GET

api

bandwidth

auto-refill

quote

Cotización de recarga de ancho 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>"
}

Cotización de recarga de ancho de banda

Devuelve lo que cuesta a tu cuenta una recarga de add_volume de ancho de banda por duration: el precio que paga por recarga una regla con estos ajustes, comisión fija incluida. No se crea ni se cobra nada. Requiere el alcance view. El precio depende de cómo hagas la llamada. Con una clave API, es el precio de una regla creada con esa clave API; desde el sitio web, el precio de una regla creada en el sitio web. Es el precio en el momento de la solicitud, y no incluye la activación de una dirección que todavía no existe on-chain — eso lo añade la primera recarga.

Parámetros de consulta

number

requerido

Ancho de banda por recarga. De 350 a 100,000, el mismo rango que al crear una regla.

string

predeterminado:"1h"

Duración del alquiler de cada recarga: 1h o 1d.

Respuesta

number

El volumen que consultaste

string

La duración que consultaste — 1h o 1d

string

Precio completo de una recarga para tu cuenta, comisión fija incluida

Ejemplo

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"
}

Errores

Estado	Código	Cuándo
`403`	`FORBIDDEN`	La clave API carece del alcance `view`
`422`	—	Falta `add_volume` o está fuera de 350 – 100,000, o `duration` no es `1h` ni `1d`
`503`	`TEMPORARILY_UNAVAILABLE`	No se pudo obtener el precio en este momento — reintenta pasados los segundos de `Retry-After`

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

Un error de validación llega en el formato del framework, con detail como array:

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

Cotización de recarga de ancho 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

Alquileres de ancho de banda

Recarga automática

Órdenes

Facturas

Smart Mode

Paquetes de transferencia

Cuenta

Webhooks

Cotización de recarga de ancho de banda

Cotización de recarga de ancho de banda

Parámetros de consulta

Respuesta

Ejemplo

Errores

​Cotización de recarga de ancho de banda

​Parámetros de consulta

​Respuesta

​Ejemplo

​Errores

Cotización de recarga de ancho de banda

Parámetros de consulta

Respuesta

Ejemplo

Errores