POST /api/auth/connect/branch

ورودی‌ها (Inputs)

نمونه:Example Request Body:

{
  “branch”"branch": 1050
}

خروجی‌ها (Outputs)

پاسخ همیشه HTTP 200 بازمی‌گردد.

خروجی موفق:

{
  “status”"status": true,
  “data”"time": 1731324000,
  "data": {
    “domain”"domain": “"example.com”com"
  }
}

در

خروجی صورت خطا:

json

ناموفق:

{
  “status”"status": false,
  “code”"code": 1201,
  “message”"message": “"کد دسترسی نا معتبر می باشد.”"
}

وابستگی‌ها (Dependencies)

نمونهٔ تست و استفاده (Testing & Usage)

ریکوئستExample زیر برای تست در Postman قابل استفاده است:cURL:

curl -X POST \

https://your-domain.yourdomain.com/api/auth/connect/branch \
  -H “"Content-Type: application/json”json" \
  -d ‘'{“branch”"branch":1050}’'

در

موارد پاسخخطا باید دامنهٔ معتبر شعبه بازگردد.

---

(Typical Error CasesCases)

جزئیات پیاده‌سازی (Conceptual Implementation)

$branch = $request->get('branch');
$code = $branch - 1000;

$office = DB::table('offices')
    ->where('id', $code)
    ->where('status', 1)
    ->select('domain')
    ->first();

if ($office) {
    return response()->json([
        'status' => true,
        'time' => now()->timestamp,
        'data' => [ 'domain' => json_decode($office->domain)[0] ],
    ]);
}
return response()->json([
    'status' => false,
    'code'   => 1201,
    'message'=> 'کد دسترسی نا معتبر می باشد.'
]);

نتیجه نتیجه نهایی (Conclusion)

این endpointEndpoint برایبدون اتصال اولیهٔ اپراتور یا سیستم خارجینیاز به دامنهٔتوکن صحیحاحراز سازمانیهویت، استفادهدامنه شعبه را تعیین می‌شودکند. طراحی آن ساده و سریع بوده و پایهٔ احراز هویت در مراحلسایر بعدیسرویس‌های (connectOtp، و connectSubmit) است.می‌باشد.

پیوست: وجودنگهداری وابستگیو امنیتیامنیت

Changelog