文档中心 > API类目 > 隐私保护API

taobao.shangou.oaid.decrypt (闪购OAID解密)

解码OAID(Open Addressee ID),返回收件人信息。

公共参数

请求参数

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

    响应参数

    名称 类型 示例值 描述
    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
    • String
    • 87.598766
    • 经度
    • └ latitude
    • String
    • 43.738733
    • 纬度
    • └ desensitize_rule
    • String
    • DECRYPTION_DISABLED_BY_ORDERCLOSED
    • 脱敏规则

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ShangouOaidDecryptRequest req = new ShangouOaidDecryptRequest();
    List<ShangouOaidDecryptRequest.ReceiverQuery> list2 = new ArrayList<ShangouOaidDecryptRequest.ReceiverQuery>();
    ShangouOaidDecryptRequest.ReceiverQuery obj3 = new ShangouOaidDecryptRequest.ReceiverQuery();
    list2.add(obj3);
    obj3.setTid("12345678");
    obj3.setOaid("xxxxxx");
    obj3.setScene("1005");
    obj3.setSecretNoDays(15L);
    req.setQueryList(list2);
    ShangouOaidDecryptResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <shangou_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>
                <desensitize_rule>DECRYPTION_DISABLED_BY_ORDERCLOSED</desensitize_rule>
            </receiver>
        </receiver_list>
    </shangou_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

    返回
    顶部