地址清洗接口-已废弃
基本信息
接口名称 | OMS_ADDRESS_PARSE |
---|---|
请求方式 | Post application/x-www-form-urlencoded |
功能描述 | 商家调用该接口将地址清洗成标准的四级地址 |
编码 | UTF-8 |
入参
项目 | 名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
对接码 | logistic_provider_id | String | 是 | 菜鸟侧提供 |
签名 | data_digest | String | 是 | Base64(Md5(logistics_interface+双方约定的secretKey)),0.2 签名方法 |
业务报文 | logistics_interface | String | 是 | JSON |
logistics_interface内容
项目 | 名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
详细地址 | detailAddress | String | 是 | 需要包含省市区信息 |
扩展信息 | extendFields | List<ExtendField> | 否 |
出参
项目 | 名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
成功标识 | success | boolean | 是 | |
国家 | country | String | 否 | |
国家id | countryId | String | 否 | |
省 | province | String | 是 | |
省id | provinceId | String | 是 | |
市 | city | String | 否 | |
市id | cityId | String | 否 | |
区县 | district | String | 否 | |
区县id | districtId | String | 否 | |
城镇 | town | String | 否 | |
城镇id | townId | String | 否 | |
详细地址 | detailAddress | String | 是 | 不包含省市区 |
经度 | longitude | String | 否 | |
纬度 | latitude | String | 否 | |
扩展信息 | extendFields | List<ExtendField> | 否 | |
错误码 | errorCode | String | 否 | |
错误说明 | errorMsg | String | 否 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardAddressParse/ediStandardAddressParse/api
请求: 仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_json
data_digest: LTfbqqyXeXBnjBJEBePe2g==
logistics_interface:
{"detailAddress":"浙江省杭州市西湖区中节能西溪首座"}
返回:
{
"town": "蒋村街道",
"city": "杭州市",
"latitude": "30.288853",
"cityId": 330100,
"townId": 330106011,
"provinceId": 330000,
"districtId": 330106,
"province": "浙江省",
"success": true,
"district": "西湖区",
"detailAddress": "中节能西溪首座",
"longitude": "120.076481"
}