وضعیت‌های سرویس
وضعیتی که در پنل می‌بینید در فیلد state است؛ یکپارچهسازی خود را بهجای status بر اساس state بسازید.
در هر پاسخ سرویس، status وضعیت خام پایگاه داده است؛ وضعیتی که در پنل می‌بینید در فیلد state قرار دارد. تصمیم‌های خود را بر اساس state بگیرید.
مقادیر state
| state | معنا |
|---|---|
preparing | نزد ارائه‌دهنده در حال آماده‌سازی است. به‌زودی active می‌شود. |
active | در حال کار است. |
expiring | در حال کار است و 7 روز یا کمتر به پایان آن مانده است (ISP، Datacenter، Gaming). |
paused | سرویس Residential/Mobile متوقف شده است (در پنل «متوقف»). دلیل آن و راه ادامه در فیلد pause_reason آمده است. |
suspended | سرویس ISP، Datacenter یا Gaming متوقف شده است. اگر pause_reason: expired باشد، تا grace_ends_at قابل تمدید است؛ اگر admin باشد، مدیر سیستم آن را تعلیق کرده و قابل تمدید نیست. |
expired | مدت آن کاملاً تمام شده یا لغو شده است. پنل این سرویس‌ها را پنهان می‌کند؛ در فهرست API هم به‌طور پیش‌فرض دیده نمی‌شوند. |
pause_reason
دلیل وضعیت paused یا suspended. در وضعیت‌های دیگر null است.
| مقدار | دلیل | چه باید کرد |
|---|---|---|
traffic_limit | محدودیت ترافیک Residential/Mobile پر شده است. | gb_limit را افزایش دهید یا بردارید. |
balance | موجودی حساب برای Residential/Mobile تمام شده است. | با افزایش موجودی حساب، خودبه‌خود ادامه می‌یابد. |
admin | مدیر سیستم آن را تعلیق کرده است. | با تمدید، تغییر محدودیت یا افزایش موجودی حساب برطرف نمی‌شود؛ با پشتیبانی تماس بگیرید. |
expired | در خانواده ISP دوره به پایان رسیده است. | تا grace_ends_at با POST /orders/{id}/renew قابل تمدید است. |
قابلیت تمدید
renewable نشان می‌دهد که آیا درخواست POST /orders/{id}/renew پذیرفته می‌شود. سرویسی که مدتش کاملاً تمام شده یا مدیر سیستم آن را تعلیق کرده، قابل تمدید نیست و 409 conflict برمی‌گرداند.
روزهای باقی‌مانده
days_left تعداد روزهای کامل باقی‌مانده است و به پایین گرد می‌شود: اگر 27 ساعت مانده باشد 1 و اگر کمتر از یک روز مانده باشد 0 است. اینکه سرویس تمام شده یا نه را state و لحظه دقیق پایان را expires_at نشان می‌دهد. در سرویس‌هایی که تاریخ پایان ندارند (پرداخت به‌اندازه مصرف)، days_left برابرnull است.