رفتن به محتوا

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

فقط سرویس‌هایی که renewable: true دارند تمدید می‌شوند: سرویسی که مدتش کاملاً تمام شده یا مدیر سیستم آن را تعلیق کرده است، 409 برمی‌گرداند. اگر قیمت قابل تعیین نباشد، هزینه‌ای کسر نمی‌شود و 503 برمی‌گردد.

⁨Residential⁩ و ⁨Mobile⁩ چون پرداخت به‌اندازه مصرف‌اند، تمدید نمی‌شوند؛ در این انواع درخواست 400 invalid_request برمی‌گرداند.

مجوزدهی

Authorizationstringالزامی

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

هدرها

Idempotency-Keystringheaderالزامی

یک مقدار یکتا برای هر تلاش تمدید. اگر مهلت درخواست تمام شد، با همان مقدار دوباره تلاش کنید؛ هزینه دو بار کسر نمی‌شود و تمدید تکمیل‌شده برگردانده می‌شود. پس از شکست قطعی (⁨4xx⁩ یا 502 همراه با details.refunded: true) کلید آزاد می‌شود و همان مقدار یک تلاش جدید را آغاز می‌کند.

پارامترهای مسیر

idstringالزامی

شناسه سرویس. آن را از فیلد id در پاسخ GET /orders بگیرید.

بدنه

monthsintegerالزامی

چند ماه تمدید شود (1 تا 12).

auto_renewboolean

هم‌زمان با تمدید، تمدید خودکار را روشن یا خاموش می‌کند.

پاسخ

200
application/json
dataobject
metaobject