文档中心 > API类目 > 代发管理

taobao.top.distribution.oaid.decrypt (分销场景解密)

分销场景解密

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
receiver_view_request ReceiverViewRequest 可选 入参
  • query_list
  • ReceiverQuery []
  • 必须
  • 查询列表
  • []
  • └ secret_no_days
  • Number
  • 可选
  • 15
  • 隐私号绑定时间
  • └ tid
  • String
  • 必须
  • 12345678
  • 交易订单ID
  • └ oaid
  • String
  • 可选
  • 收件人ID (Open Addressee ID),长度在128个字符之内。
  • 隐私号绑定时间
  • └ scene
  • String
  • 可选
  • 1005
  • 解密场景编号。不同场景,解密策略不同。请根据产品功能选择相应的场景编号。可选的场景:1001(顺丰电子面单发货)、1002(4通一达电子面单发货)、1003(EMS电子面单发货)、1004(其他电子面单发货)、1005(线下门店发货)、1006(手工单发货)、1007(代发货)、2001(客户售后服务)、2002(客户关怀),详情点击

响应参数

名称 类型 示例值 描述
receiver_list Receiver [] 收件人列表
  • └ tid
  • String
  • 123456
  • 交易编号
  • └ oaid
  • String
  • xxxx
  • 收件人ID (Open Addressee ID),长度在128个字符之内。
  • └ address_detail
  • String
  • 淘宝城911号
  • 收件人的详细地址
  • └ town
  • String
  • 三墎镇
  • 收货人街道地址
  • └ district
  • String
  • 西湖区
  • 收货人的所在地区
  • └ city
  • String
  • 杭州市
  • 收货人的所在城市
  • └ state
  • String
  • 浙江省
  • 收货人的所在省份
  • └ country
  • String
  • 中国
  • 收货人国籍
  • └ phone
  • String
  • 010-12345678
  • 收件人的电话号码
  • └ mobile
  • String
  • 13012345678
  • 收件人的手机号,privacy_protection=true是为隐私号,格式为18877771111-123
  • └ name
  • String
  • 张三
  • 收件人的姓名
  • └ matched
  • Boolean
  • true
  • oaid是否和tid当前的oaid匹配。true:匹配,false:不匹配。当不匹配时,建议通过taobao.trade.fullinfo.get获取最新的oaid。
  • └ secret_no_expire_time
  • Date
  • 2021-09-01 00:00:00
  • 隐私号过期时间,privacy_protection=true时有值
  • └ privacy_protection
  • Boolean
  • true
  • 标记订单是否为隐私保护订单,为true时,mobile为隐私号
  • └ longitude
  • Boolean
  • 87.598766
  • 经度
  • └ latitude
  • String
  • 43.738733
  • 纬度

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TopDistributionOaidDecryptRequest req = new TopDistributionOaidDecryptRequest();
TopDistributionOaidDecryptRequest.ReceiverViewRequest obj1 = new TopDistributionOaidDecryptRequest.ReceiverViewRequest();
List<TopDistributionOaidDecryptRequest.ReceiverQuery> list3 = new ArrayList<TopDistributionOaidDecryptRequest.ReceiverQuery>();
TopDistributionOaidDecryptRequest.ReceiverQuery obj4 = new TopDistributionOaidDecryptRequest.ReceiverQuery();
list3.add(obj4);
obj4.setSecretNoDays(15L);
obj4.setTid("12345678");
obj4.setOaid("收件人ID (Open Addressee ID),长度在128个字符之内。");
obj4.setScene("1005");
obj1.setQueryList(list3);
req.setReceiverViewRequest(obj1);
TopDistributionOaidDecryptResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<top_distribution_oaid_decrypt_response>
    <receiver_list>
        <receiver>
            <tid>123456</tid>
            <oaid>xxxx</oaid>
            <address_detail>淘宝城911号</address_detail>
            <town>三墎镇</town>
            <district>西湖区</district>
            <city>杭州市</city>
            <state>浙江省</state>
            <country>中国</country>
            <phone>010-12345678</phone>
            <mobile>13012345678</mobile>
            <name>张三</name>
            <matched>true</matched>
            <secret_no_expire_time>2021-09-01 00:00:00</secret_no_expire_time>
            <privacy_protection>true</privacy_protection>
            <longitude>87.598766</longitude>
            <latitude>43.738733</latitude>
        </receiver>
    </receiver_list>
</top_distribution_oaid_decrypt_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部