接口说明

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

注意：地址校验接口由于供应商环境限制，暂不支持沙箱环境测试，请直接调用生产环境

使用场景

卖家使用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"
    }
}

关键词

WO06.德国地址校验接口