POST /api/v2/trade/national

Route Info

تحلیل عملکرد (Analysis)

مکانیزم شناسایی شهر

SELECT * FROM cities WHERE national_prefix LIKE '%123%' LIMIT 1;
  

منطق اعتبارسنجی کد ملی

ورودی‌ها (Inputs)

{
  "code": "0451234567"
}
  

خروجی‌ها (Outputs)

خروجی موفق (شهر یافت شد)

{
  "status": true,
  "time": 1731926417,
  "data": "تبریز"
}
  

خروجی معتبر اما بدون شهر

{
  "status": true,
  "time": 1731926417,
  "data": "کد ملی صحیح می باشد. اما شهر یافت نشد"
}
  

خروجی نامعتبر (کد اشتباه)

{
  "status": false,
  "time": 1731926417,
  "data": "کد ملی نامعتبر"
}
  

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

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

POST /api/v2/trade/national
Content-Type: application/json

{
  "code": "4580021347"
}
  

موارد خطا (Typical Error Cases)

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

public function nationalPrefix(Request $request)
{
    if (Validator::nationalCode($request->code)) {
        $Code = City::where('national_prefix', 'LIKE', '%' . substr($request->code, 0, 3) . '%')->first();
        if (!is_null($Code))
            return ['status' => true, 'time' => time(), 'data' => $Code->fa_name];
        else
            return ['status' => true, 'time' => time(), 'data' => 'کد ملی صحیح می باشد. اما شهر یافت نشد'];
    } else
        return ['status' => false, 'time' => time(), 'data' => 'کد ملی نامعتبر'];
}
  

نتیجه‌گیری (Conclusion)

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