通过mdmcode批量查询国家/地区信息

通过mdmcode批量查询国家/地区信息。资源介绍请参考概述。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/mdm/v3/batch_country_region
HTTP Method	GET
接口频率限制	10 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	mdm:country_region:read 查询国家/地区的公共数据

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
fields	string\[\]	是	需要的查询字段集 示例值：name 数据校验规则： - 长度范围：1 ～ 100
ids	string\[\]	是	主数据编码集 示例值：MDCT00000001 数据校验规则： - 长度范围：1 ～ 100
languages	string\[\]	是	希望返回的语言种类，支持格式如下： - 中文：zh-CN - 英文：en-US - 日文：ja-JP 对于多语文本字段，传入特定语言，将会返回对应语言文本 示例值：en-US 数据校验规则： - 长度范围：0 ～ 100

请求体示例

{}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ data	country_region\[\]	国家/地区目录列表
└ alpha_3_code	string	三位字母代码。与ISO国家代码的三位代码一致。
└ alpha_2_code	string	两位字母代码。与ISO国家代码的二位代码一致。
└ numeric_code	string	数字代码。与ISO国家代码的Numeric代码一致
└ name	i18n_string	国家/地区名称
└ value	string	入参languages中排序第一的语言对应的值。
└ multilingual_value	map<string, string>	入参languages中所有语言对应的值。
└ return_language	string	value实际返回的值对应的语言，如"zh-CN"
└ mdm_code	string	主数据编码（系统生成的唯一永久代码，格式为“MDCT+8位数字”）
└ full_name	i18n_string	国家/地区全称
└ value	string	入参languages中排序第一的语言对应的值。
└ multilingual_value	map<string, string>	入参languages中所有语言对应的值。
└ return_language	string	value实际返回的值对应的语言，如"zh-CN"
└ global_code	string	国际电话区号
└ status	string	是否生效。0代表否，1代表是
└ continents	enum	所属大洲。可选值如下1-亚洲，2-欧洲，3-非洲，4-北美洲，5-南美洲，6-大洋洲，7-南极洲）
└ value	string	入参languages中排序第一的语言对应的值。
└ multilingual_name	map<string, string>	入参languages中所有语言对应的值。

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "data": [
            {
                "alpha_3_code": "AND",
                "alpha_2_code": "AD",
                "numeric_code": "20",
                "name": {
                    "value": "安道尔",
                    "multilingual_value": {
                        "zh-CN": "安道尔"
                    },
                    "return_language": "zh-CN"
                },
                "mdm_code": "MDCT00000001",
                "full_name": {
                    "value": "安道尔公国",
                    "multilingual_value": {
                        "zh-CN": "安道尔公国"
                    },
                    "return_language": "zh-CN"
                },
                "global_code": "+376",
                "status": "1",
                "continents": {
                    "value": "2",
                    "multilingual_name": {
                        "zh-CN": "欧洲"
                    }
                }
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1640201	invalid params	参数非法，请检查参数
400	1640202	param not found	参数为空，请检查参数填写是否完整
400	1640203	object field not found	此字段不在查询范围内，请检查
400	1640204	language is invalid	非法语言，请重新填写
400	1640205	params is required	必填参数未填写，请检查
400	1640206	limit too large	查询数量过大，请限制在1000以内
400	1640207	limit plus offset too large	查询数量和起始位置加和过大，请限制在10000以内
400	1640208	page token invalid	分页码无效，请检查该参数
400	1640209	record id not found	未发现符合条件行级记录，请检查查询参数
400	1640210	sort by null is not allowed	排序参数填写有误，请检查
400	1640211	biz codes is empty	业务编码为空，请检查
400	1640212	mdm codes is empty	主数据编码为空，请检查
400	1640213	biz id is invalid	业务编码非法，请检查
500	1640101	system error	系统错误，联系飞书技术支持排查
500	1640102	invalid generic method	请求方法错误，联系飞书技术支持排查
500	1640103	call meta service error	请求元数据方法错误，联系飞书技术支持排查
500	1640104	meta data not found	找不到对应元数据，联系飞书技术支持排查
500	1640105	data source request invalid	数据库请求非法，联系飞书技术支持排查
500	1640106	db error	数据库错误，联系飞书技术支持排查
500	1640107	func not supported yet	服务不支持该方法，联系飞书技术支持排查
500	1640108	field type not supported yet	字段类型不支持，联系飞书技术支持排查
500	1640109	validator not found	未发现数据校验规则，联系飞书技术支持排查
500	1640110	transformer not found	未发现数据转换规则，联系飞书技术支持排查
500	1640111	executor not found	未发现执行器，联系飞书技术支持排查
500	1640112	invalid data source type	错误数据库类型，联系飞书技术支持排查
500	1640113	data source not found	未发现数据库，联系飞书技术支持排查
500	1640114	data source invalid	数据库无效，联系飞书技术支持排查
500	1640115	meta setting not found	未发现元数据配置，联系飞书技术支持排查
500	1640116	generate page token error	分页码生成错误，联系飞书技术支持排查
500	1640117	record duplicate error	行级记录重复，联系飞书技术支持排查
500	1640118	generate idl error	idl生成错误，联系飞书技术支持排查
500	1640119	producer not found error	消息生产者错误，联系飞书技术支持排查
500	1640120	custom func request error	自定义执行器请求错误，联系飞书技术支持排查
500	1640121	custom func response error	自定义执行器响应错误，联系飞书技术支持排查