文档中心 > API类目 > 淘宝交易API

taobao.top.secret.extend (虚拟号延期)

虚拟号延期

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
extend_request SecretNoExtendRequest 必须 虚拟号延期请求
  • └ extend_days
  • Number
  • 必须
  • 7
  • 虚拟号有效期延长天数,发货场景只能填7、15、30
  • └ oaid
  • String
  • 必须
  • xxxx
  • 收件人ID (Open Addressee ID),长度在128个字符之内。
  • └ order_id
  • Number
  • 必须
  • 12345678
  • 交易订单ID
  • └ scene
  • String
  • 必须
  • 1005
  • 解密场景编号。不同场景,解密策略不同。请根据产品功能选择相应的场景编号。可选的场景:1001(顺丰电子面单发货)、1002(4通一达电子面单发货)、1003(EMS电子面单发货)、1004(其他电子面单发货)、1005(线下门店发货)、1006(手工单发货)、1007(代发货)、2001(客户售后服务)、2002(客户关怀)

响应参数

名称 类型 示例值 描述
result SecretNo 隐私号延期返回结果
  • └ secret_no
  • String
  • 18031098000-292
  • 隐私号
  • └ expire_time
  • String
  • 2021-01-01 00:00:00
  • 延期后隐私号的过期时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TopSecretExtendRequest req = new TopSecretExtendRequest();
TopSecretExtendRequest.SecretNoExtendRequest obj1 = new TopSecretExtendRequest.SecretNoExtendRequest();
obj1.setExtendDays(7L);
obj1.setOaid("xxxx");
obj1.setOrderId(12345678L);
obj1.setScene("1005");
req.setExtendRequest(obj1);
TopSecretExtendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<top_secret_extend_response>
    <result>
        <secret_no>18031098000-292</secret_no>
        <expire_time>2021-01-01 00:00:00</expire_time>
    </result>
</top_secret_extend_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>

错误码解释

错误码 错误描述 解决方案
isv.non-secret-no 该订单未绑定虚拟号,不能延期。 首先检查此订单是否为号码保护订单,是则忽略,不是则检查是否此appeky通过解密接口绑定过虚拟号,如果发现绑定过仍报本错误,可以提工单查询。
isv.extend-out-of-range 延期次数过多,已达到绑定上限 如果确实履约需要,可以提工单延长时间。或去千牛订单详情查看订单真实手机号。

API工具

如何获得此API

FAQ

返回
顶部