رفتن به محتوا

اگر موجودی باشد، حداکثر به اندازه موجودی، و اگر نباشد (پیش‌سفارش)، دست‌کم 250 عدد می‌توان سفارش داد. فیلد sufficient نشان می‌دهد که تعداد درخواستی شما تأمین می‌شود یا نه.

اگر target_url را ندهید، موجودی حالت همه سایت‌ها برمی‌گردد؛ این همان عددی است که در پاسخ GET /locations می‌آید. target_url باید یکی از اهداف پشتیبانی‌شده باشد (GET /target-urls)؛ در غیر این صورت، مانند نقطه پایانی سفارش، 400 و details.unsupported_targets برمی‌گردد.

یک location_id ناشناخته 400 برمی‌گرداند. اگر نوع سرویس در حال نگهداری باشد، maintenance: true و sufficient: false برمی‌گردد.

مجوزدهی

Authorizationstringالزامی

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

پارامترهای کوئری

typeenum<string>الزامی

نوع سرویس.

location_idintegerالزامی

شناسه موقعیت. آن را از نقطه پایانی GET /locations بگیرید.

quantityinteger

تعداد IP (1 تا 1000).

target_urlstring

دامنه هدف برای سفارش هدفمند؛ موجودی بر اساس همان هدف محاسبه می‌شود.

پاسخ

200
application/json
dataobject