API Principal
Calcular preço de bandwidth
Preço exato de um pedido de bandwidth para um volume e uma duração, taxa fixa incluída
GET
Calcular preço de bandwidth
Calcular preço de bandwidth
Retorna o valor exato que será cobrado por um pedido de bandwidth com este volume e esta duração — aluguel e taxa fixa juntos, pela sua tarifa. A cotação é calculada pelo mesmo código que cobra o pedido; por isso, enquanto o preço não muda, a compra custa exatamentetotal_trx.
Este endpoint é público — a autenticação é opcional. Envie sua chave de API para receber a sua
tarifa e a sua taxa fixa; sem ela você obtém o preço público.
Parâmetros de consulta
integer
obrigatório
Unidades de bandwidth a cotar. Entre 1 e 100.000.
string
padrão:"1h"
Período de aluguel:
1h, 1d ou um número inteiro de minutos de 5m a 59m — os mesmos valores de
Comprar bandwidth.Cabeçalhos
string
Opcional. Com uma chave válida a resposta reflete sua tarifa negociada e sua taxa fixa. Chave
ausente, inválida ou revogada não é erro — você recebe o preço público com
personal_price: false.Resposta
number
Unidades de bandwidth para as quais a cotação foi calculada
string
Período de aluguel para o qual a cotação foi calculada
string
Tarifa em SUN por 1 unidade de bandwidth, arredondada a 0,01 para exibição. Os prazos em minutos têm
desconto, por isso a tarifa deles é fracionária, e os valores abaixo são calculados a partir da tarifa
exata — use
total_trx em vez de multiplicar você mesmo este valor arredondado.string
Custo de aluguel para este volume e esta duração, sem a taxa fixa
string
Taxa fixa, cobrada uma vez por pedido, independentemente do volume e da duração. Reflete a sua
taxa caso haja taxa personalizada, desconto ou isenção na sua conta.
string
O que será cobrado:
rental_trx + fixed_fee_trx. Envie-o como max_price_trx em
Comprar bandwidth.boolean
true quando sua tarifa negociada foi aplicada, false quando a cotação usa o preço público.
Verifique este campo: um cabeçalho X-API-Key esquecido parece uma resposta normal, e você estaria
cotando o preço público aos seus clientes enquanto é cobrado pelo seu.Exemplo
Os valores abaixo são um exemplo, com
price_sun_1h igual a 400 e short_max_discount_pct igual a 5. As
tarifas e o desconto atuais estão em Consultar preços de bandwidth.Response
O que a cotação não inclui
Agindo em nome de outra conta: GET /v1/bandwidth/quote/me
/bandwidth/quote calcula o preço para o dono da chave de API. Se a sua chave age em nome de outra
conta com o cabeçalho X-Account-Id, a compra é cobrada pela tarifa e pela taxa dessa conta — a cotação
pode diferir da cobrança, e um max_price_trx tirado dela pode ser recusado com 409 PRICE_CHANGED.
Nesse caso, use GET /v1/bandwidth/quote/me. Ele aceita os mesmos parâmetros de consulta e retorna a
mesma resposta, mas exige autenticação, e a conta é determinada exatamente como na compra,
X-Account-Id incluído. Ele exige o escopo view, que toda chave sempre tem.
cURL
Erros
Em
/bandwidth/quote uma X-API-Key inválida ou revogada não é erro: a cotação é retornada
ao preço público com personal_price: false.