API
德国地址校验
更新时间: 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 门牌号

请求示例

  1. {
  2. "action": "winit.tools.address.isValid",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "15972C5334CCC7AB588DA3AAD284DD8D",
  6. "data": {
  7. "city": "Hasbergen",
  8. "country": "DE",
  9. "houseNo": "25",
  10. "street": "Tecklenb3urger Str.",
  11. "zipcode": "49205"
  12. },
  13. "format": "json",
  14. "language": "zh_CN",
  15. "platform": "OWNERERP",
  16. "sign": "FD66831E7AF15BC13DA4B0C7AD38FC06",
  17. "sign_method": "md5",
  18. "timestamp": "2015-06-16 00:19:26",
  19. "version": "1.0"
  20. }

返回出参

返回参数说明:正确的返回编码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 邮编

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "result": false,
  6. "suggestionList": [
  7. {
  8. "zipcode": "49205",
  9. "city": "Hasbergen",
  10. "street": "Mecklenburger Str."
  11. },
  12. {
  13. "zipcode": "49205",
  14. "city": "Hasbergen",
  15. "street": "Tecklenburger Str."
  16. },
  17. {
  18. "zipcode": "49205",
  19. "city": "Hasbergen",
  20. "street": "Alte Tecklenburger Str."
  21. }
  22. ],
  23. "resultMsg": "Street not found"
  24. }
  25. }