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

taobao.top.package.auth.info.get (淘宝末端包裹信息获取)

淘宝末端包裹信息获取

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
is_privacy_package_request IsPrivacyPackageRequest 必须 查询类
  • └ mail_no
  • String
  • 必须
  • SFXXXX
  • 运单号
  • └ cp_code
  • String
  • 可选
  • SF/STO/YTO等
  • 快递公司编码
  • └ black_mobiles
  • String
  • 可选
  • 1803109,181310
  • 柜机黑名单手机号前7位,如有多个用英文逗号,分隔,每个元素仅前七位有效

响应参数

名称 类型 示例值 描述
result IsPrivacyPackageResponse 结果
  • └ privacy_package
  • Boolean
  • true
  • 是否为隐私包裹
  • user_auth_infos
  • UserAuthInfo []
  • 用户授权信息
  • └ mobile
  • String
  • 180310xxxxx
  • 收件人手机号
  • └ authorize_expire_time
  • Date
  • 2022-08-01
  • 授权信息过期时间
  • └ open_id
  • String
  • xxxx
  • 用户唯一标识
  • └ secret_no
  • String
  • 180310xxxxx-9999
  • 虚拟号
  • └ secret_expire_time
  • Date
  • 2022-08-01
  • 虚拟号过期时间
  • └ cp_code
  • String
  • ZTO
  • 运单所属快递公司code
  • └ main_secret_no
  • Boolean
  • false
  • 收件人手机号是否为虚拟号主号(虚拟号前11位)
  • └ black
  • Boolean
  • false
  • 收件人手机号是否在柜机黑名单中

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TopPackageAuthInfoGetRequest req = new TopPackageAuthInfoGetRequest();
TopPackageAuthInfoGetRequest.IsPrivacyPackageRequest obj1 = new TopPackageAuthInfoGetRequest.IsPrivacyPackageRequest();
obj1.setMailNo("SFXXXX");
obj1.setCpCode("SF/STO/YTO等");
obj1.setBlackMobiles("1803109,181310");
req.setIsPrivacyPackageRequest(obj1);
TopPackageAuthInfoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<top_package_auth_info_get_response>
    <result>
        <privacy_package>true</privacy_package>
        <user_auth_infos>
            <user_auth_info>
                <mobile>180310xxxxx</mobile>
                <authorize_expire_time>2022-08-01</authorize_expire_time>
                <open_id>xxxx</open_id>
                <secret_no>180310xxxxx-9999</secret_no>
                <secret_expire_time>2022-08-01</secret_expire_time>
                <cp_code>ZTO</cp_code>
                <main_secret_no>false</main_secret_no>
                <black>false</black>
            </user_auth_info>
        </user_auth_infos>
    </result>
</top_package_auth_info_get_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

返回
顶部