POST /b2c/v1/get_country

Get Nationalities List 

 این اندپوینت لیست کشورهای فعال که دارای عنوان «ملیت» (Nationality) تعریف شده هستند را باز می‌گرداند. از این داده‌ها معمولاً در فرم‌های ورود اطلاعات مسافر جهت انتخاب ملیت/تابعیت (مثلاً: ایرانی، آلمانی و...) استفاده می‌شود. لیست خروجی تنها شامل رکوردهایی است که وضعیت آن‌ها فعال (`status = 1`) باشد. 

 

 

 

 Fetch Country/Nationality Data 

 

 

 URL: /b2c/v1/get_country 

 Method: POST 

 Controller: V1UserController@getCitizen 

 Auth: Public (Guest Access) 

 

 

 Parameters 

 این درخواست نیاز به پارامتر ورودی (Body Parameters) ندارد. 

 

 Response Structure 

 

 

 

 

 Key 

 Type 

 Description 

 

 

 

 

 status 

 Boolean 

 وضعیت درخواست (true). 

 

 

 data.countries 

 Array 

 آرایه‌ای از آبجکت‌های کشور/ملیت. 

 

 

 ↳ id 

 Integer 

 شناسه عددی کشور در دیتابیس. 

 

 

 ↳ iso 

 String 

 کد دو حرفی ایزو کشور (مثلاً IR, US). 

 

 

 ↳ fa_nationality 

 String 

 عنوان فارسی ملیت (مثلاً: ایرانی). 

 

 

 ↳ en_nationality 

 String 

 عنوان انگلیسی ملیت (مثلاً: Iranian). 

 

 

 

 

 Example Responses 

 ۱. موفقیت آمیز (200 OK): 

 {

 "status": true,

 "time": 1702138899,

 "data": {

 "countries": [

 {

 "id": 105,

 "iso": "IR",

 "fa_nationality": "ایرانی",

 "en_nationality": "Iranian"

 },

 {

 "id": 220,

 "iso": "TR",

 "fa_nationality": "ترک",

 "en_nationality": "Turkish"

 },

 {

 "id": 68,

 "iso": "DE",

 "fa_nationality": "آلمانی",

 "en_nationality": "German"

 }

 ]

 }

} 

 ۲. خطای سرور (400 Bad Request): 

 {

 "status": false,

 "error": "Database connection error..."

} 

 

 Technical Logic 

 

 

 Request Received 

 ↓ 

 Query Database (Countries) WHERE status = 1 AND fa_nationality IS NOT NULL 

 ↓ 

 Select Columns id, iso, fa_nationality, en_nationality 

 ↓ 

 Return JSON Response