رفتن به محتوا

همان قیمت‌گذاری، همان تخفیف پلن و همان بررسی موجودی IP و موجودی حساب اعمال می‌شود. پروتکل، موقعیت، دامنه‌های هدف یا حالت همه سایت‌ها و همه گزینه‌های اضافی پشتیبانی می‌شوند.

اگر نام کاربری و رمز عبور ارسال نشوند، خودکار ساخته می‌شوند و در پاسخ برمی‌گردند (اگر توکن مجوز proxies:read را هم داشته باشد). اگر نام سرویس ارسال نشود، با همان قالب پنل ساخته می‌شود. اینکه کدام فیلدها برای هر نوع معتبرند، در جدول صفحه عملیات هزینه‌بر آمده است؛ فیلدهای ناشناخته رد می‌شوند.

ممکن است سفارش بلافاصله فعال نشود (آماده‌سازی، پیش‌سفارش یا تأخیر ارائه‌دهنده). اگر meta.ready برابر ⁨false⁩ باشد، meta.warning پر برمی‌گردد؛ پیش از به کار گرفتن سرویس، نقطه پایانی جزئیات سرویس را به‌طور دوره‌ای بررسی کنید تا state برابر ⁨active⁩ شود.

مجوزدهی

Authorizationstringالزامی

به‌صورت Bearer <token> ارسال می‌شود. این نقطه پایانی مجوز orders:write (ثبت سفارش) را لازم دارد؛ توکنی که این مجوز را نداشته باشد پاسخ 403 می‌گیرد.

هدرها

Idempotency-Keystringheaderالزامی

یک مقدار یکتا برای هر تلاش سفارش (مثلاً ⁨UUID⁩). اگر مهلت درخواست تمام شد، با همان مقدار دوباره تلاش کنید؛ هزینه دو بار کسر نمی‌شود. مقدار را در یک متغیر نگه دارید و برای تلاش مجدد مقدار جدید نسازید.

بدنه

orderTypeenum<string>الزامی

نوع سرویس؛ در این صفحه gaming.

locationIdintegerالزامی

برای ⁨ISP⁩، ⁨Datacenter⁩ و ⁨Gaming⁩ الزامی است. آن را از نقطه پایانی GET /locations بگیرید. کشور به‌طور خودکار از موقعیت تعیین می‌شود.

quantityintegerالزامی

برای ⁨ISP⁩، ⁨Datacenter⁩ و ⁨Gaming⁩ الزامی است، 1 تا 1000. اگر موجودی IP نباشد، سفارش به پیش‌سفارش تبدیل می‌شود و دست‌کم 250 عدد لازم است.

protocolenum<string>پیش‌فرض: socks5

⁨ISP⁩، ⁨Datacenter⁩ و ⁨Gaming⁩. auto: ⁨HTTP⁩ و ⁨SOCKS5⁩ روی یک پورت، به‌علاوه ⁨UDP ASSOCIATE⁩؛ http: فقط ⁨HTTP/HTTPS⁩؛ socks5: فقط ⁨SOCKS5⁩. اگر ارسال نشود، در ⁨ISP⁩ و ⁨Datacenter⁩ مقدار auto و در ⁨Gaming⁩ مقدار socks5 به کار می‌رود (default_protocol در پاسخ GET /catalog). نام مستعار parentUpstreamProtocol هم پذیرفته می‌شود (⁨AUTO⁩، ⁨HTTP⁩ یا ⁨SOCKS⁩؛ بزرگی و کوچکی حروف مهم نیست)؛ فقط یکی از این دو را ارسال کنید. در ⁨Residential/Mobile⁩ ارسال نمی‌شود؛ آنجا ⁨HTTP⁩ و ⁨SOCKS5⁩ هم‌زمان، روی پورت‌های جداگانه کار می‌کنند.

highConnectionboolean

اتصال بالا. در خانواده ⁨ISP⁩ هزینه اضافه دارد: 100 اتصال هم‌زمان به‌ازای هر IP به‌جای 50. در ⁨Residential/Mobile⁩ رایگان است: محدودیت اتصال گیت‌وی به‌جای 500، به 1000 می‌رسد؛ در پاسخ با options.high_connection دیده می‌شود.

extraIpWhitelistboolean

فقط خانواده ⁨ISP⁩: ظرفیت اضافه برای لیست سفید IP، با هزینه اضافه برای هر سفارش. در ⁨Residential/Mobile⁩ پاسخ 400 invalid_request برمی‌گرداند.

nonSequentialIpsboolean

خانواده ⁨ISP⁩: IPهای غیرمتوالی (پراکنده)، با هزینه اضافه.

highSpeedboolean

خانواده ⁨ISP⁩: پهنای باند 2 برابر، با هزینه اضافه.

usernamestring

اختیاری؛ اگر ارسال نشود، خودکار ساخته می‌شود و در پاسخ برمی‌گردد. 3 تا 40 کاراکتر: حرف، رقم، _ یا -. برای انتخاب آن توسط خودتان، پلن شما باید اجازه دهد؛ در غیر این صورت tier_required برمی‌گردد.

passwordstring

اختیاری؛ اگر ارسال نشود، خودکار ساخته می‌شود. 6 تا 40 کاراکتر؛ @ . : ! و فاصله مجاز نیستند. نمی‌تواند با نام کاربری یکسان باشد. رمز عبوری را که # / ? % دارد، هنگام استفاده در آدرس (مثلاً socks5://user:pass@host) به‌صورت ⁨percent-encoded⁩ درآورید؛ رمزهایی که سیستم می‌سازد # ندارند.

gateNamestring

اختیاری. نام سرویس که در پنل دیده می‌شود، حداکثر 80 کاراکتر. اگر ارسال نشود، با قالب پنل ساخته می‌شود (مثلاً ISP Proxy #a1b2c3d4).

پاسخ

200
application/json
dataobject
metaobject