API Principal
Calcular precio de bandwidth
Precio exacto de un pedido de bandwidth para un volumen y una duración, comisión fija incluida
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 exactamentetotal_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.
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
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.