API
Заказы и покупки
Покупка выполняется двумя запросами: сначала расчёт цены, затем покупка с заголовком Idempotency-Key. Повторный запрос покупки с тем же значением возвращает первый заказ и не списывает баланс повторно.
Обновлено 22 ноября 2026
Цены и наличие#
| Запрос | Что возвращает |
|---|---|
| GET /pricing/me | Цены аккаунта по всем продуктам и срокам. |
| GET /catalog/availability?proxy_type=isp | Локации, где продукт можно купить сейчас: datacenter, isp, mtproto или residential. |
| GET /mobile/locations?in_stock=true | Мобильные локации с операторами, ценами и возможностями. Идентификатор локации служит её location_code. |
Шаг 1. Расчёт цены#
POST /orders/quote возвращает текущую стоимость нового заказа. Покупка не выполняется. Нужно право read или purchase.
| Поле | Значение |
|---|---|
| proxy_type | datacenter, isp, residential, mobile или mtproto |
| location_code | Код страны, например US, город, например us_la, или идентификатор мобильной локации |
| proxy_count | От 1 до 1000. Для резидентских это гигабайты |
| duration_days | От 1 до 365 |
| variant | Необязательно. web для Telegram WEB, pro для Residential Pro |
| features | Необязательно, только мобильные. Нужные возможности устройства |
Ответ содержит unit_price (за прокси, для резидентских за гигабайт), total, balance и enough_balance. Промокод или разовая реферальная скидка могут только уменьшить сумму списания.
Шаг 2. Покупка#
POST /orders принимает те же поля, а также location_name (название в личном кабинете), unit_price из расчёта и необязательный promo_code. Нужно право purchase.
PLAN='{"proxy_type":"datacenter","location_code":"US","proxy_count":2,"duration_days":30}'
# 1. The price. Nothing is bought.
PRICE=$(curl -s https://proxya.co/api/v1/orders/quote \
-H "Authorization: Bearer $PROXYA_API_KEY" \
-H "Content-Type: application/json" \
-d "$PLAN" | jq -r .unit_price)
# 2. The purchase. One key per purchase, the same key on every retry.
KEY=$(uuidgen)
curl https://proxya.co/api/v1/orders \
-H "Authorization: Bearer $PROXYA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $KEY" \
--max-time 300 \
-d "$(echo "$PLAN" | jq --arg p "$PRICE" '. + {location_name: "United States", unit_price: $p}')"Idempotency-Key#
- Покупка, продление и восстановление по ключу передаются с заголовком
Idempotency-Key: от 1 до 128 печатных символов ASCII, новое значение для каждой покупки. - В течение 24 часов запрос с тем же значением и тем же телом возвращает первый ответ: тот же заказ или ту же ошибку. Повторного списания нет.
- То же значение с другим телом получает
409. Повтор, пока первый запрос ещё выполняется, тоже получает409. - Неудачная покупка под тем же значением не повторяется. Проверьте список заказов и выполните покупку с новым значением.
unit_price должен совпадать с текущей ценой. Если цена изменилась между шагами, покупка получает 400. Запросите новый расчёт и повторите покупку.
Заказы#
curl "https://proxya.co/api/v1/orders?status=active&limit=50" \
-H "Authorization: Bearer $PROXYA_API_KEY"
curl https://proxya.co/api/v1/orders/$ORDER_ID \
-H "Authorization: Bearer $PROXYA_API_KEY"GET /ordersпринимаетstatus,proxy_type,search,pageиlimitдо 100.GET /orders/{id}возвращает заказ с прокси иrenew_options.{id}этоidзаказа или егоorder_number.- Статусы:
pending,provisioning,active,expiring,suspended,terminated,expired,cancelled. Заказ в статусеprovisioningещё выдаётся: запросите его позже. - Без права credentials прокси возвращаются с пустыми логинами, паролями и ссылками, у заказа стоит
credentials_hidden: true.
Продление#
Поле renew_options заказа содержит все сроки, на которые его можно продлить, с текущей ценой за прокси. POST /orders/{id}/extend принимает duration_days и unit_price из этого списка и требует Idempotency-Key.
import uuid
order = session.get(f"{API}/orders/{order_id}", timeout=30).json()
option = next(o for o in order["renew_options"] if o["duration_days"] == 30)
renewed = session.post(
f"{API}/orders/{order_id}/extend",
json={"duration_days": option["duration_days"], "unit_price": str(option["unit_price"])},
headers={"Idempotency-Key": str(uuid.uuid4())},
timeout=300,
)
renewed.raise_for_status()
print(renewed.json()["expires_at"])POST /orders/{id}/restore с тем же телом восстанавливает прекращённый заказ ISP или датацентра в течение 7 дней после прекращения, с прежними IP и доступами. Правила по продуктам описаны на странице Заказы и продление.
Не нашли ответ?
Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.