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

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

接口英文名

winit.tools.address.isValid

使用场景

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

备注

请求说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.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": "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"
}

                        
返回出参
名称 类型 必填 说明 示例
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": {
        "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"
    }
}