Saltar al contenido principal
GET
Calcular precio de bandwidth

Calcular precio de bandwidth

Devuelve el importe exacto que se cobrará por un pedido de bandwidth de este volumen y esta duración — alquiler y comisión fija juntos, a su tarifa. La cotización se calcula con el mismo código que cobra el pedido, así que mientras el precio no cambie la compra cuesta exactamente total_trx. Este endpoint es público — la autenticación es opcional. Envíe su clave API para recibir su propia tarifa y comisión fija; sin ella obtendrá el precio público.
Muestre total_trx a su usuario y páselo como max_price_trx a Comprar bandwidth. Si el precio cambia entre la cotización y la compra, la compra se rechaza con 409 PRICE_CHANGED y no se cobra nada — vuelva a cotizar y reintente.

Parámetros de consulta

integer
requerido
Unidades de bandwidth a cotizar. Entre 1 y 100,000.
string
predeterminado:"1h"
Periodo de alquiler: 1h, 1d o un número entero de minutos de 5m a 59m — los mismos valores que en Comprar bandwidth.

Cabeceras

string
Opcional. Con una clave válida la respuesta refleja su tarifa negociada y su comisión fija. Una clave ausente, inválida o revocada no es un error: obtendrá el precio público con personal_price: false.

Respuesta

number
Unidades de bandwidth para las que se calculó la cotización
string
Periodo de alquiler para el que se calculó la cotización
string
Tarifa en SUN por 1 unidad de bandwidth, redondeada a 0.01 para mostrarla. Los plazos en minutos llevan descuento, por lo que su tarifa es fraccionaria, y los importes siguientes se calculan con la tarifa exacta: tome total_trx en lugar de multiplicar usted mismo este valor redondeado.
string
Costo de alquiler para este volumen y esta duración, sin la comisión fija
string
Comisión fija, cobrada una vez por pedido sin importar el volumen ni la duración. Refleja su propia comisión si a su cuenta se le aplica una comisión personalizada, un descuento o una exención.
string
Lo que se le cobrará: rental_trx + fixed_fee_trx. Páselo como max_price_trx a Comprar bandwidth.
boolean
true cuando se aplicó su tarifa negociada, false cuando la cotización va al precio público. Compruébelo: una cabecera X-API-Key olvidada parece una respuesta normal, y estaría cotizando a sus clientes el precio público mientras se le cobra el suyo.

Ejemplo

Los valores siguientes son un ejemplo, con price_sun_1h de 400 y short_max_discount_pct de 5. Las tarifas actuales y el descuento están en Obtener precios de bandwidth.
Response

Lo que la cotización no incluye

La cotización — y max_price_trx — cubre solo el pedido de bandwidth. Si la dirección de destino aún no está activada on-chain, Comprar bandwidth la activa y cobra la activación aparte (activation_cost_trx en su respuesta). Ese cargo no forma parte de total_trx y no se compara con max_price_trx.

Actuar sobre otra cuenta: GET /v1/bandwidth/quote/me

/bandwidth/quote calcula el precio para el propietario de la clave API. Si su clave actúa sobre otra cuenta con la cabecera X-Account-Id, la compra se cobra a la tarifa y la comisión de esa cuenta — la cotización puede diferir del cargo, y un max_price_trx tomado de ella puede rechazarse con 409 PRICE_CHANGED. En ese caso, use GET /v1/bandwidth/quote/me. Acepta los mismos parámetros de consulta y devuelve la misma respuesta, pero requiere autenticación, y la cuenta se determina exactamente igual que en la compra, X-Account-Id incluido. Requiere el alcance view, que toda clave tiene siempre.
cURL

Errores

En /bandwidth/quote una X-API-Key inválida o revocada no es un error: la cotización se devuelve al precio público con personal_price: false.