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

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

接口英文名

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"
    }
}