#P1460
Route: POST /api/v2/online/{type}/status
Route Info
| Method |
Endpoint |
Controller |
Middleware |
Purpose |
| POST |
/api/v2/online/{type}/status |
OnlineController@statusItemProgress |
authWithJwt |
دریافت وضعیت فعلی قفل یا رزرو (Flight/Train) |
منطق عملکرد
- ساخت
BaseService و فراخوانی statusItemProgress($request‑>all(), $request‑>get('branch'))
- مقدار خروجی در متغیر
$DataBaseService
- بازگرداندن پاسخ در دو کلید اصلی:
changed → آیا تغییری در وضعیت اتفاق افتاده؟data → جزئیات وضعیت فعلی آیتم
- مدیریت خطاها مشابه unlock با code 1002
پاسخ نمونه موفق
{
"status": true,
"time": 1732050560,
"changed": false,
"data": {
"lock_id": 9372,
"progress": "locked",
"expires_in": 120,
"payload": {
"service": "flight",
"origin": "IKA",
"destination": "IST"
}
}
}
پاسخ خطا
{
"status": false,
"time": 1732050560,
"error": {
"code": 1002,
"message": "Invalid lock identifier",
"trace": [...]
}
}
وابستگیها
BaseService::statusItemProgress()- جداول کنترل لاک موقت و Redis (در صورت فعال)
یادداشت توسعه
- اضافه کردن «progress_history» به پاسخ برای ردیابی رویدادهای لاک.
