#P1459
Route: POST /api/v2/online/{type}/unlock
Route Info
| Method | Endpoint | Controller | Middleware | Purpose |
| POST | /api/v2/online/{type}/unlock | OnlineController@unlockItemProgress | authWithJwt | رفع قفل آیتم (Flight/Train) در Temporary Reservation |
منطق عملکرد
- ورودی (تمام دادههای درخواست) از $request دریافت میشود.
- نمونهای از
\App\Lib\BaseServiceایجاد میشود. - فراخوانی تابع
BaseService::unlockItemProgress($request‑>all(), $request‑>get('branch')). - پاسخ دریافتی در
dataبه صورت JSON بازگردانده میشود. - در صورت خطا (Code 1002)، جزئیات trace و مشخصات پشتیبانی برمیگردد.
ورودیها
دادهها بر اساس نوع سرویس ({type}) تغییر میکنند، اما حداقل پارامترها عبارتند از:
branch: شناسهٔ شعبهlock_id: شناسه قفل موقت در جدولtemporary_reservationstoken|progress_id: شناسه داخلی لاک
پاسخ نمونه موفق
{
"status": true,
"time": 1732050510,
"data": {
"unlocked": true,
"id": 9372,
"message": "Lock released successfully"
}
}
پاسخ خطا
{
"status": false,
"time": 1732050510,
"error": {
"code": 1002,
"message": "Lock not found or already expired",
"trace": [...]
},
"support": {
"phone": "021‑91016838 in 121",
"email": "ict@airplus.app",
"panel": "helpdesk.airplus.app"
}
}
وابستگیها
BaseService::unlockItemProgress()- مدیریت Table
temporary_reservations
نکات توسعه
- بهتر است در نسخه بعدی، تاریخ Expiry لاک در خروجی نمایش داده شود.