رفتن به محتوا

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

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

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

مجوزدهی

Authorizationstringالزامی

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

هدرها

Idempotency-Keystringheaderالزامی

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

بدنه

orderTypeenum<string>الزامی

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

highConnectionboolean

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

countryCodestring

⁨Residential/Mobile⁩: کشور پیش‌فرض در سطح سفارش، با کد ⁨ISO⁩ (⁨TR, DE, US, GB, FR, IT, ES, NL, PL, RU⁩). در خانواده ⁨ISP⁩ کشور از locationId می‌آید؛ اگر آنجا ارسال شود، رد می‌شود.

gbLimitnumber

⁨Residential/Mobile⁩، اختیاری: محدودیت ترافیک (گیگابایت)، دست‌کم 0.001. 0 یعنی محدودیت ثابتی وجود ندارد. اگر ارسال نشود، سقف مصرف به موجودی حساب شما محدود است.

usernamestring

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

passwordstring

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

gateNamestring

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

پاسخ

200
application/json
dataobject
metaobject