德国地址校验
更新时间: 2024-10-24 12:04:07 访问次数:11188
接口说明
该接口提供给第三方平台或是卖家自有系统。
注意:地址校验接口由于供应商环境限制,暂不支持沙箱环境测试,请直接调用生产环境
使用场景
卖家使用DHL Paket Service (1-2 business days)可以通过该接口验证收货人德国地址是否正确,减少因地址错误产生地址校验附加费。
卖家使用DPD Domestic Normal Parcels (1-2 business days)或DPD Domestic Small Parcels (1-2 business days)时,使用该地址校验接口,增加妥投成功率。
接口名称
winit.tools.address.isValid
请求说明
请求内容 | 说明 |
---|---|
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
country | String(3) | N | ISO国家码,默认是DE | DE |
city | String(50) | Y | 城市 | |
zipcode | String(7) | Y | 邮编 | |
street | String(50) | Y | 街道,winit的地址1 | |
houseNo | String(5) | Y | 门牌号 |
请求示例
{
"action": "winit.tools.address.isValid",
"app_key": "rebecca",
"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"client_sign": "15972C5334CCC7AB588DA3AAD284DD8D",
"data": {
"city": "Hasbergen",
"country": "DE",
"houseNo": "25",
"street": "Tecklenb3urger Str.",
"zipcode": "49205"
},
"format": "json",
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "FD66831E7AF15BC13DA4B0C7AD38FC06",
"sign_method": "md5",
"timestamp": "2015-06-16 00:19:26",
"version": "1.0"
}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
名称 | 类型 | 必传 | 说明 | 示例 |
---|---|---|---|---|
result | Boolean | Y | 校验结果 | true/false |
resultMsg | String() | Y | 不通过原因 | Street not found |
suggestionList | Array | Y | 建议地址列表 | |
– city | String() | Y | 城市 | |
– street | String() | Y | 街道 | |
– zipcode | String() | Y | 邮编 |
返回示例
{
"code": "0",
"msg": "操作成功",
"data": {
"result": false,
"suggestionList": [
{
"zipcode": "49205",
"city": "Hasbergen",
"street": "Mecklenburger Str."
},
{
"zipcode": "49205",
"city": "Hasbergen",
"street": "Tecklenburger Str."
},
{
"zipcode": "49205",
"city": "Hasbergen",
"street": "Alte Tecklenburger Str."
}
],
"resultMsg": "Street not found"
}
}
关键词