Основное API
Рассчитать цену bandwidth
Точная цена заказа bandwidth для объёма и срока, с учётом фиксированной комиссии
GET
Рассчитать цену bandwidth
Рассчитать цену bandwidth
Возвращает точную сумму, которая будет списана за заказ bandwidth такого объёма и срока, — аренда и фиксированная комиссия вместе, по вашей ставке. Котировка рассчитывается тем же кодом, который списывает оплату за заказ, поэтому, пока цена не изменилась, покупка стоит ровноtotal_trx.
Эндпоинт публичный — аутентификация не обязательна. Передайте свой API-ключ, чтобы получить котировку по своей ставке и своей фиксированной комиссии; без него вернётся публичная цена.
Параметры запроса
integer
обязательно
Объём bandwidth для расчёта. От 1 до 100 000.
string
по умолчанию:"1h"
Срок аренды:
1h, 1d или целое число минут от 5m до 59m — те же значения, что и в Купить bandwidth.Заголовки
string
Необязательный. С действующим ключом ответ отражает вашу согласованную ставку и вашу фиксированную комиссию. Отсутствующий, неверный или отозванный ключ — не ошибка: вы получите публичную цену с
personal_price: false.Ответ
number
Объём bandwidth, для которого рассчитана котировка
string
Срок аренды, для которого рассчитана котировка
string
Ставка в SUN за 1 единицу bandwidth, округлённая до 0.01 для отображения. На минутные сроки действует скидка, поэтому их ставка дробная, а суммы ниже рассчитаны по точной ставке — берите
total_trx, а не умножайте это округлённое значение сами.string
Стоимость аренды для этого объёма и срока, без фиксированной комиссии
string
Фиксированная комиссия, берётся один раз за заказ независимо от объёма и срока. Отражает вашу комиссию, если для аккаунта настроена индивидуальная комиссия, скидка или её снятие.
string
Сумма, которая будет списана:
rental_trx + fixed_fee_trx. Передайте её как max_price_trx в Купить bandwidth.boolean
true, если применилась ваша согласованная ставка, false — если котировка по публичной цене. Проверяйте это поле: забытый заголовок X-API-Key иначе выглядит как обычный ответ, и вы будете показывать клиентам публичную цену, а списываться будет ваша.Пример
Значения ниже — пример, при
price_sun_1h, равном 400, и short_max_discount_pct, равном 5. Актуальные ставки и скидка — в Получить цены bandwidth.Response
Что не входит в котировку
Действия от имени другого аккаунта: GET /v1/bandwidth/quote/me
/bandwidth/quote считает цену для владельца API-ключа. Если ваш ключ действует от имени другого аккаунта через заголовок X-Account-Id, покупка списывается по ставке и комиссии этого аккаунта — котировка может отличаться от списания, а max_price_trx, взятый из неё, может быть отклонён с 409 PRICE_CHANGED.
В этом случае используйте GET /v1/bandwidth/quote/me. Он принимает те же параметры запроса и возвращает тот же ответ, но аутентификация обязательна, а аккаунт определяется ровно так же, как при покупке, включая X-Account-Id. Для него нужен скоуп view, который всегда есть у любого ключа.
cURL
Ошибки
На
/bandwidth/quote неверный или отозванный X-API-Key — не ошибка: котировка вернётся по публичной цене с personal_price: false.