Country list

Interface Overview:
Retrieve country list data.
This interface returns all countries, which are generally updated infrequently.

Recommended Requests
Initialize data: Request the interface once to get current countries.
Update data: Request updated data at fixed intervals.
Suggested frequency: Once per day

Request

Query Params

country_id

string

optional

根据国家ID筛选，支持多选，ID间用英文逗号隔开

page

integer

optional

页数

per_page

integer

optional

每页数据条数，不传时默认返回20条数据

recent_update

string

optional

更新时间：筛选最近时间段更新的数据，支持30m,1h,12h,48h

language

string

optional

多语言名称,详细参数看API指南（全局多语言），不传该参数默认返回英文

Responses

🟢200成功

application/json

Body

code

integer

错误码

required

0-代表请求成功

data

object

required

list

array [object {9}]

required

total

integer

数据总条数

required

msg

string

接口信息

required

Example

{
    "code": 0,
    "data": {
        "list": [
            {
                "country_id": 4,
                "category_id": 1,
                "name": "德国",
                "name_en": "Germany",
                "abbr": "德国",
                "abbr_en": "GER",
                "logo": "/football/country/ce409783958293f9246ae796a06c2bc0.png",
                "lang": {
                    "name_zh": "",
                    "name_zh_tw": "",
                    "name_en": "",
                    "name_es": "",
                    "name_pt_br": "",
                    "name_fr": "",
                    "name_tr": "",
                    "name_de": "",
                    "name_sv": "",
                    "name_el": "",
                    "name_ru": "",
                    "name_uk": "",
                    "name_da": "",
                    "name_pl": "",
                    "name_ko": "",
                    "name_nl": "",
                    "name_ms": "",
                    "name_tl": "",
                    "name_vi": "",
                    "name_ar": "",
                    "name_th": "",
                    "name_hi": "",
                    "name_ja": ""
                },
                "update_time": 1728958472
            },
            {
                "country_id": 8,
                "category_id": 1,
                "name": "荷兰",
                "name_en": "Netherlands",
                "abbr": "荷兰",
                "abbr_en": "NL",
                "logo": "/football/country/dc946ba9f883da6b8315cb2f5042f1f3.png",
                "lang": {
                    "name_zh": "",
                    "name_zh_tw": "",
                    "name_en": "",
                    "name_es": "",
                    "name_pt_br": "",
                    "name_fr": "",
                    "name_tr": "",
                    "name_de": "",
                    "name_sv": "",
                    "name_el": "",
                    "name_ru": "",
                    "name_uk": "",
                    "name_da": "",
                    "name_pl": "",
                    "name_ko": "",
                    "name_nl": "",
                    "name_ms": "",
                    "name_tl": "",
                    "name_vi": "",
                    "name_ar": "",
                    "name_th": "",
                    "name_hi": "",
                    "name_ja": ""
                },
                "update_time": 1728958472
            }
        ],
        "total": 2
    },
    "msg": "success"
}

Request

Request samples

Responses