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_typedatacenter, 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. Запросите новый расчёт и повторите покупку.

Заказы#

Shell
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 и доступами. Правила по продуктам описаны на странице Заказы и продление.

Не нашли ответ?

Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.