更新时间：2024-09-30 GMT+08:00
商品过期
接口说明
- 客户购买的商品过期时，云商店调用该接口，商家接到该通知以后应该将指定的实例冻结。
- 针对过期场景接口调用失败的情况，云商店会持续调用1小时后停止调用，“卖家中心>生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
- 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
- 云商店会对接口异常的情况做监控，如SaaS商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。
商品过期流程如下图所示：
请求消息
请求参数说明请参见下表：
请求方法：GET
|
参数 |
是否必选 |
类型 |
最大字符长度 |
说明 |
|---|---|---|---|---|
|
activity |
M |
String |
20 |
接口请求标识，用于区分接口请求场景。 过期场景取值：expireInstance |
|
authToken |
M |
String |
50 |
安全校验令牌。 取值请参见authToken取值说明。 |
|
instanceId |
M |
String |
64 |
实例ID |
|
orderId |
M |
String |
64 |
新购商品时对应的订单ID。 |
|
timeStamp |
M |
String |
20 |
请求发起时的时间戳，取UTC时间。 格式：yyyyMMddHHmmssSSS |
|
testFlag |
O |
Integer |
1 |
是否调测数据。
|
请求消息示例：
https://example.isv.com?activity=expireInstance&instanceId=03pf80c2bae96vc49b80b917bea776d7 &timeStamp=20170725025113409&testFlag=0&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=
响应消息
响应参数说明请参见下表：
|
参数 |
是否必选 |
类型 |
最大字符长度 |
说明 |
|---|---|---|---|---|
|
resultCode |
M |
String |
6 |
调用结果码。 具体请参见调用结果码说明。 |
|
resultMsg |
O |
String |
255 |
调用结果描述。 |
- 商家的服务器在处理接口请求时，需要做好幂等性处理。
- 云商店服务有可能重发请求，针对同一instanceId，商家的服务器不应该重复做实例过期处理，返回成功响应即可。
父主题： 接口描述
