通用接口

国家/地区列表

此接口更新频率极低,请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/region

请求

参数
类型
是否必传
备注

响应

参数
类型
是否必传
描述

code

String

国家/地区代码 ISO 3166-1 alpha-2

standardCode

String

国家/地区代码 ISO 3166-1 alpha-3

name

String

国家/地区名称

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "AU",
            "standardCode": "AUS",
            "name": "Australia"
        },
        {
            "code": "BD",
            "standardCode": "BGD",
            "name": "Bangladesh"
        }
    ]
}

城市列表

此接口更新频率极低,请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/city

请求

参数
类型
是否必传
备注

regionCode

String

false

国家/地区代码 ISO 3166-1 alpha-2

响应

参数
类型
是否必传
描述

code

String

城市代码

name

String

城市名称

country

String

国家/地区代码 ISO 3166-1 alpha-2

countryStandardCode

String

国家/地区代码 ISO 3166-1 alpha-3

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "AUK",
            "name": "test",
            "country": "AU",
            "countryStandardCode": "AUB",
        }
    ]
}

城市列表-v2

包含了省份/州/地区、城市两个层级

此接口更新频率极低,请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/v2/city

请求

参数
类型
是否必传
备注

regionCode

String

false

国家/地区代码 ISO 3166-1 alpha-2

响应

参数
类型
是否必传
描述

code

String

城市代码

name

String

城市名称

country

String

国家/地区代码 ISO 3166-1 alpha-2

countryStandardCode

String

国家/地区代码 ISO 3166-1 alpha-3

parentCode

String

父级code。0是最高层级;代表省份/州/地区

children

List

子城市列表

children[0].code

String

城市代码

children[0].name

String

城市名称

children[0].country

String

国家/地区代码 ISO 3166-1 alpha-2

children[0].countryStandardCode

String

国家/地区代码 ISO 3166-1 alpha-3

children[0].parentCode

String

父级code。0是最高层级;代表省份/州/地区

children[0].children

List

子城市列表

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "AU-ACT",
            "name": "澳大利亚首都特区",
            "parentCode": "0",
            "country": "AU",
            "countryStandardCode": "AUS",
            "children":
            [
                {
                    "code": "AU-ACT-80100",
                    "name": "堪培拉",
                    "parentCode": "AU-ACT",
                    "country": "AU",
                    "countryStandardCode": "AUS",
                    "children":
                    []
                }
            ]
        }
    ]
}

手机区号列表

此接口更新频率极低,请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/mobileAreaCode

请求

参数
类型
是否必传
备注

响应

参数
类型
是否必传
描述

code

String

电话区号

name

String

所属地区名称

areaCode

String

所属地区代码 ISO 3166-1 alpha-2

language

String

地区语言

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "+1",
            "name": "Canada",
            "areaCode": "CA",
            "language": "en_US"
        }
    ]
}

上传文件

content-type=multipart/form-data;此接口签名请生成一个空对象进行签名

只支持jpg、png、pdf格式;文件大小不能超过2M

POST /merchant/core/mcb/common/file/upload

请求

参数
类型
是否必传
备注

category

String

请使用默认值:card

file

File

文件

响应

参数
类型
是否必传
描述

fileId

String

文件ID

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "fileId": "c7bf3c1b-25d1-4b75-b519-1e6bf383d0a7"
    }
}

Last updated