Skip to main content
#P1781

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
Back to top