Skip to main content
POST
Create Order

Авторизации

Authorization
string
header
обязательно

Ключ вида lumi_proxy_… Выдаётся оператором.

Заголовки

authorization
string | null
Idempotency-Key
string | null

Тело

application/json

One proxy purchase.

quantity is GB for rotating categories (residential / mobile) and the number of IPs for static ones (isp / datacenter).

Rotating purchases MERGE by default: a category the user already owns an active subscription in is topped up rather than duplicated (the same rule the bot enforces). Pass subscription_id to target one explicitly, or read back is_top_up to see what happened.

category
string
обязательно

residential | mobile | isp | datacenter

Maximum string length: 32
quantity
integer
обязательно
Требуемый диапазон: 1 <= x <= 1000
country
string | null

ISO-2 code or catalog name. Required for isp/datacenter.

Maximum string length: 64
region
string | null
Maximum string length: 128
city
string | null
Maximum string length: 128
isp
string | null
Maximum string length: 128
rotation_seconds
integer | null

rotating only; omit for a new IP on every request

Требуемый диапазон: 1 <= x <= 604800
session_mode
enum<string>
по умолчанию:rotating
Доступные опции:
rotating,
sticky
protocol
enum<string>
по умолчанию:http
Доступные опции:
http,
socks5
format
enum<string>
по умолчанию:url
Доступные опции:
url,
user:pass@host:port,
user:pass:host:port,
host:port:user:pass
auto_renew
boolean
по умолчанию:false

static only

subscription_id
integer | null

rotating only - force the top-up target

Ответ

Successful Response

status
string
обязательно
category
string
обязательно
subscription_id
integer | null
order_id
integer | null
price_usd
string | null
quantity
integer | null
country
string | null
is_top_up
boolean
по умолчанию:false
geo_applied
boolean
по умолчанию:false
geo_failed
boolean
по умолчанию:false