淘宝开放平台

登录
文档中心 > API类目 > 服务平台API

服务平台API

qimen.tmall.service.reserve.address.check (校验上门地址是否在服务范围)

校验上门地址是否在服务范围

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
addressList Struct [] 必须
  • 最大列表长度：999
    		•  地址列表
    • └ province
    • String
    • 必须
    • 上海
    • 省
    • └ addressDetail
    • String
    • 必须
    • 中诚苑小区
    • 详细地址
    • └ city
    • String
    • 必须
    • 上海市
    • 市
    • └ town
    • String
    • 必须
    • 龙华街道
    • 街道
    • └ area
    • String
    • 必须
    • 徐汇区
    • 区
    • └ townDivisionCode
    • String
    • 可选
    • 310104016
    • 四级区域编码
    • └ divisionCode
    • String
    • 可选
    • 310104
    • 三级区域编码
    buyerId Number 可选 4112547387 用户id
    servTradeOrderId String 必须 132134321234354321 服务订单号
    buyer_open_uid String 可选 1 openuid

    响应参数

    名称 类型 示例值 描述
    data Data 数据
    • addressList
    • AddressList []
    • 地址列表
    • └ area
    • String
    • 余杭区
    • 区
    • └ town
    • String
    • 五常街道
    • 街道
    • └ city
    • String
    • 杭州市
    • 市
    • └ addressDetail
    • String
    • 西溪园区6号楼吧
    • 详细地址
    • └ province
    • String
    • 浙江省
    • 省
    • └ townDivisionCode
    • String
    • 310104016
    • 四级区域编码
    • └ disabled
    • Boolean
    • true
    • true 为不可选择
    • └ disabledReason
    • String
    • 超出商圈范围
    • 不可选择原因
    • └ divisionCode
    • String
    • 310104
    • 三级区域编码
    errorCode String 301 错误码
    errorMsg String flow_limit 错误信息
    success Boolean true 是否成功

    请求示例

    {"buyer_open_uid":"1","addressList":[{"area":"徐汇区","divisionCode":"310104","addressDetail":"中诚苑小区","province":"上海","town":"龙华街道","city":"上海市","townDivisionCode":"310104016"}],"servTradeOrderId":"132134321234354321","buyerId":0}

    响应示例

    {
    "data":{
        "addressList":[
            {
                    "area":"余杭区",
                    "town":"五常街道",
                    "city":"杭州市",
                    "addressDetail":"西溪园区6号楼吧",
                    "province":"浙江省",
                    "townDivisionCode":"310104016",
                    "disabled":true,
                    "disabledReason":"超出商圈范围",
                    "divisionCode":"310104"
            }
        ]
    },
    "errorCode":"301",
    "errorMsg":"flow_limit",
    "success":true
}

    验签示例

    {"success":"false","errorCode":"sign-check-failure","errorMsg":"Illegal request"}

    错误码解释

    错误码 错误描述 解决方案
    isp.http-read-timeout

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部