开发者文档
德国地址校验接口

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)时,使用该地址校验接口,增加妥投成功率。


公共参数

请求地址:

环境

HTTPS请求地址

正式环境

http://openapi.winit.com.cn/openapi/service

测试环境

http://openapi.sandbox.winit.com.cn/openapi/service

公共请求参数:

参数

类型

是否必填

最大长度

描述

示例值

app_key

String


用户名

rebecca

action

String


接口名称

winit.tools.address.isValid

timestamp

String

20

时间

2015-06-16 00:19:26

version

String


版本

1.0

sign

String


签名(增加链接,可连接到文档或者测试工具)

1001

sign_method

String


签名方式

md5

format

String


格式

Json

platform

String


平台

参见链接

language

String


语言

zh_CN

data

String


业务参数

由业务参数构造 "data": {}

请求参数

参数

类型

必填

长度

描述

示例值

zipcode

String

7

邮编


street

String

50

街道,winit的地址1


city

String

50

城市


houseNo

number

5

门牌号


country

String

3

ISO国家码,默认是DE

DE

公共响应参数

参数

类型

是否必填

最大长度

描述

示例值

code

String

-

网关返回码


msg

String


网关返回码描述,代表调用接口网络是否通畅

服务不可用

响应参数

参数

类型

必填

长度

描述

示例值

data

Container


-



result

Boolean



校验结果

true/false

resultMsg

String



不通过原因

Street not found

suggestionList

Array



数据数组


--|city

String



商品条码


--|street

String



商品编码


--|zipcode

String



商品规格


请求示例

·         Json

{

      "action":"winit.tools.address.isValid",

    "app_key":"rebecca",

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

}

·         JSON示例响应示例

{

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

         }

      ]

   }

}


异常示例

JSON示例

{
      
"code":"-1",
      
"msg":"操作失败",
      
"data":{
 
      }

  }

错误码解释

错误码

错误描述

解决方案

0

操作成功


-1

操作失败


02033502039

网络访问异常

调整网络,重试