API
德国地址校验
更新时间: 2017-11-22 17:16:42 访问次数:3614
接口说明

该接口提供给第三方平台或是卖家自有系统。

使用场景

卖家使用DHL Paket Service (1-2 business days)可以通过该接口验证收货人德国地址是否正确,减少因地址错误产生地址校验附加费。卖家使用DPD Domestic Normal Parcels (1-2 business days)或DPD Domestic Small Parcels (1-2 business days)时,使用该地址校验接口,增加妥投成功率。

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
zipcode String(7) Y 邮编
street String(50) Y 街道,winit的地址1
city String(50) Y 城市
houseNo String(5) Y 门牌号
country String(3) N ISO国家码,默认是DE DE
请求示例
{
    "action":"winit.tools.address.isValid",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"38B87482C92FFEF0F10292B7AFA44087",
    "data":{
          "city":"Hasbergen",
         "country":"DE",          
          "houseNo":"25",
            "street":"Tecklenb3urger Str.",
           "zipcode":"49205"
        
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2015-06-16   00:19:26",
    "version":"1.0"
}

                        
返回出参
名称 类型 必填 说明 示例
data Container
result Boolean Y 校验结果 true/false
resultMsg String() Y 不通过原因 Street not found
suggestionList Array 建议,以下为子节点
--|city String() Y 城市
--|street String() Y 街道
--|zipcode String() Y 邮编
返回示例
{
      "code":   "0",
   "msg": "操作成功",
   "data":    {
      "resultMsg":   "Street not found",
      "result":   false,
        "suggestionList":         [
                  {
              "street": "Mecklenburger Str.",
              "zipcode": "49205",
              "city": "Hasbergen"
         },
                  {
              "street": "Tecklenburger Str.",
            "zipcode":   "49205",
              "city": "Hasbergen"
         },
                  {
              "street": "Alte Tecklenburger Str.",
              "zipcode": "49205",
              "city": "Hasbergen"
         }
      ]
   }
}