## 3.2 地区接口 ### 1. 地区列表 GET： ~~~ /sport/api/v1/regions ~~~ 接口概述：获取地区列表 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 否 | 页数 | | per_page | int | 否 | 每页数据条数 | | sport_id | int | 是 | 运动ID | | token | string | 是 | 客户密钥 | | day | int | 否 | 可以填写1-7，1代表24小时内变动数据筛选；7代表一周内变动数据筛选，2-6以此类推；若不填写或填写错误此参数不生效 | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /sport/api/v1/regions?sport_id=201&page=1&per_page=100&token=XXXXX ~~~ 返回示例 ```json { "code": 0, "data": { "list": [ { "id": 22, //地区id "pid": 10, //上一级ID（比如巴西属于美洲,这个10是美洲的ID） "name": "美洲", //地区名 "abbr": "美洲", //地区简称 "name_en": "", //地区英文名 "logo": " ", //logo "icon": "", //icon "alias": [ //别名 "美洲" ... ], "sport_id": 202 //运动id "update_time": 1690885714 //更新时间 "total": 137 //数据条数 }, "msg": "" } ``` ### 2.地区详情 GET： ~~~ /sport/api/v1/regions/{region_id} ~~~ 接口概述：获取地区详情数据 建议频率：查询时调用 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | id | int | 是 | 地区ID | | token | string | 是 | 客户密钥 | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /sport/api/v1/regions/101?token=XXXXX ~~~ 返回格式示例 ~~~ { "id": 48, //ID "pid": 10, //上一级ID 比如巴西属于美洲,这个10是美洲的ID "name": "巴西", //地区名 "abbr": "巴西", //简称 "name_en": "Brazil", //地区英文名 "logo": "https://example.png", //地区LOGO "icon": "", //地区ICON "alias": [ //别名 "巴西", "Brazil", "巴西" ], "sport_id": //运动ID "lang":{ "name_zh_tw":" ", //繁体中文 "name_es":" ", //西班牙语 "name_pt":" ", //葡萄牙语 "name_fr":" ", //法语 "name_de":" ", //德语 "name_sv":" ", //瑞典语 "name_ru":" ", //俄语 "name_uk":" ", //乌克兰语 "name_da":" ", //丹麦语 "name_pl":" ", //波兰语 "name_nl":" ", //荷兰语 "name_ko":" ", //韩语 "name_ms":" ", //马来语 "name_tl":" ", //他加禄语 "name_vi":" ", //越南语 "name_el":" ", //希腊语 "name_tr":" ", //土耳其语 "name_thai":" ", //泰语 "name_ar":" " //阿拉伯语 "name_hi":" " //印度语 }, } ~~~ | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | id | int | 地区ID | | | name | string | 地区名 | | | name_en | string | 地区英文名 | | | abbr | string | 地区简称 | | | logo | string | 地区logo | | lang | string | 多语言字段（地区名）|