В этом руководстве показано, как купить новые прокси через API с нуля — посмотреть доступные варианты, рассчитать цену, оформить заказ и получить купленные IP.

Каждый запрос использует ваш персональный API-ключ из личного кабинета (как получить API-ключ). В примерах ниже замените YOUR_API_KEY на свой ключ. Чтобы оплатить с баланса аккаунта, используйте paymentId = 1.

⚠️ Шаг оформления заказа списывает средства с баланса. Сначала всегда проверяйте стоимость на шаге расчёта.

Кратко о процессе

Проверьте баланс.
Узнайте, что можно заказать (страна, период).
Выберите способ оплаты (или используйте баланс).
Рассчитайте цену.
Оформите заказ.
Получите купленные прокси.

Шаг 1 — Проверьте баланс

Убедитесь, что на балансе достаточно средств для покупки.

Эндпоинт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get

Ответ

{
  "status": "success",
  "data": { "summ": 10 },
  "errors": []
}

Шаг 2 — Узнайте, что можно заказать

Reference List возвращает всё необходимое для заказа: страны, периоды, цели, операторов и ротации (для мобильных). Скопируйте нужные countryId и periodId.

Эндпоинт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}

Параметры пути

Имя	Значение	Описание
type	`ipv4`	Тип прокси (ipv4, ipv6, mobile, isp, mix, mix_isp).

Пример

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4

Ответ

{
  "status": "success",
  "data": {
    "items": [
      {
        "country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
        "period":  [ { "id": "1m", "name": "1 month" } ]
      }
    ]
  },
  "errors": []
}

Шаг 3 — Выберите способ оплаты

Получите список доступных платёжных систем и скопируйте нужный id как paymentId. Чтобы оплатить с баланса, просто используйте paymentId = 1.

Эндпоинт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Ответ

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Шаг 4 — Рассчитайте цену

Рассчитайте стоимость заказа перед покупкой. Скидки за объём и срок аренды применяются так же, как на сайте. Этот шаг ничего не списывает.

Поля тела зависят от типа прокси. Общие поля ниже; для IPv6 также передайте protocol, для mobile — operatorId + rotationId, для residential — tarifId — всё из Reference List.

Эндпоинт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Тело запроса

Имя	Тип	Описание
countryId	Number	ID страны из Reference List (шаг 2).
periodId	String	ID периода аренды из Reference List.
quantity	Number	Количество прокси для заказа.
paymentId	Number	ID платёжной системы. `1` = баланс, `43` = привязанная карта.
coupon (необязательный)	String	Код купона, если он у вас есть.
authorization (необязательный)	String	Способ авторизации. Оставьте пустым, чтобы использовать логин:пароль.
customTargetName (необязательный)	String	Своё название цели/таргета, если нужно.

Пример

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Ответ — shows the total, your balance, the discount and the per-proxy price:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 2000,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.45,
    "price": 1.8
  },
  "errors": []
}

Шаг 5 — Оформите заказ (списывает с баланса)

Когда рассчитанная цена вас устраивает, оформите заказ. Этот шаг списывает средства с баланса. Используйте те же параметры, что и на шаге 4. Из ответа скопируйте orderId.

Эндпоинт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Тело запроса

Имя	Тип	Описание
countryId	Number	ID страны из Reference List (шаг 2).
periodId	String	ID периода аренды из Reference List.
quantity	Number	Количество прокси для заказа.
paymentId	Number	ID платёжной системы. `1` = баланс, `43` = привязанная карта.
coupon (необязательный)	String	Код купона, если он у вас есть.
authorization (необязательный)	String	Способ авторизации. Оставьте пустым, чтобы использовать логин:пароль.
generateAuth (необязательный)	String	Y/N — создать кастомную авторизацию (по умолчанию N).

Пример

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Ответ — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 2426273,
    "total": 16.2,
    "listBaseOrderNumbers": [ "3388485_57471911" ],
    "balance": 1776.88
  },
  "errors": []
}

Шаг 6 — Получите купленные прокси

Получите купленные прокси. Отфильтруйте по orderId из предыдущего шага, чтобы увидеть именно купленное.

Эндпоинт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Ответ

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "date_start": "23.06.2024",
        "date_end": "23.07.2024"
      }
    ]
  },
  "errors": []
}