文档首页/云空间服务 KooDrive/API参考(运营商)/API/权益发放/通知用户套餐过期进入保留期 - notifyPackageExpire
更新时间:2026-02-03 GMT+08:00

通知用户套餐过期进入保留期 - notifyPackageExpire

功能介绍

通知用户套餐过期进入保留期,该功能需要添加白名单才能调用这个接口

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/carrier/users/notifyPackageExpire

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

参数解释:

该字段存储的是 Access Token。

调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。

约束限制:

格式参考:Bearer+/access token}

取值范围:

Access Token的获取请参考对应的开发手册

默认取值:

不涉及

X-Date

String

参数解释:

签名时间,用于appId鉴权

约束限制:

距当前时间15分钟以内,不能晚于当前时间

取值范围:

yyyMMdd'T'HHmmss'Z',例:20251103T070140Z

默认取值:

不涉及

X-User-Id

String

参数解释:

koodrive侧用户id,用于appId鉴权

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

x-traceid

String

参数解释:

业务跟踪id(必须58位)

约束限制:

不涉及

取值范围:

长度为58位

默认值:

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

carrierUserId

String

参数解释:

运营商用户id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

type

Integer

参数解释:

修改类型

约束限制:

不涉及

取值范围:

2-进入保留期

默认取值:

不涉及

packageId

String

参数解释:

运营商套餐id,运营商保证唯一

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code

String

状态码

msg

String

状态描述

请求示例

/koodrive/ose/v1/carrier/users/notifyPackageExpire

{
  "carrierUserId" : "189642158555241211",
  "type" : 1,
  "packageId" : "14"
}

响应示例

状态码:200

通知用户套餐过期进入保留期 响应体

{
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

通知用户套餐过期进入保留期 响应体