文档首页/云空间服务 KooDrive/API参考(运营商)/API/权益发放/运营商反向通知接口-按需订购 - reverseOrder
更新时间:2026-02-03 GMT+08:00

运营商反向通知接口-按需订购 - reverseOrder

功能介绍

运营商反向通知接口-按需订购

授权信息

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

URI

POST /koodrive/ose/v1/carrier/operation/reverseOrder

请求参数

表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参数

参数

是否必选

参数类型

描述

operationList

Array of ReverseOperationAllPropertiesInfo objects

参数解释:

操作列表

约束限制:

限制50个元素

取值范围:

不涉及

默认取值:

不涉及

batchSN

String

参数解释:

批量操作流水号

约束限制:

长度限制64个字符

取值范围:

不涉及

默认取值:

不涉及

表3 ReverseOperationAllPropertiesInfo

参数

是否必选

参数类型

描述

packageChangeList

Array of PackageChangeInfo objects

参数解释:

套餐修改动作集

约束限制:

限制1个元素

取值范围:

不涉及

默认取值:

不涉及

operationSN

String

参数解释:

操作流水号

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

carrierUserId

String

参数解释:

运营商用户id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表4 PackageChangeInfo

参数

是否必选

参数类型

描述

changeType

Integer

参数解释:

变更类型

约束限制:

不涉及

取值范围:

1:订购

默认取值:

不涉及

packageId

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

packageType

Integer

参数解释:

套餐类型

约束限制:

当packageId字段传入时,该字段必传

取值范围:

-2:连续包月基础套餐

-3:连续包年基础套餐

-4:基于基础套餐的扩容包

-5:单独的扩容包

默认取值:

不涉及

capacity

Integer

参数解释:

套餐容量

约束限制:

当packageId字段传入时,该字段必传

取值范围:

单位KB

默认取值:

不涉及

activateTime

String

参数解释:

激活时间, ISO 标准时间格式

约束限制:

changeType=1时候必填,需要在当前计费周期内;changeType=0时非必填

取值范围:

不涉及

默认取值:

不涉及

packageName

String

参数解释:

套餐名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

status

String

参数解释:

套餐状态

约束限制:

不涉及

取值范围:

0-下线;1-发布

默认取值:

不涉及

price

String

参数解释:

套餐价格

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

promotionPrice

String

参数解释:

套餐折扣价

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

countryCode

String

参数解释:

国家/地区代码,参照ISO 3166-1 alpha-3

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

currencyCode

String

参数解释:

货币代码,参照ISO 4217标准

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

count

Integer

参数解释:

订购数量

约束限制:

不涉及

取值范围:

不涉及

默认取值:

1

channel

String

参数解释:

渠道字段,

约束限制:

不涉及

取值范围:

要求以 00、01、02 或 03 开头,后跟任意6个字符(总共8个字符)

默认取值:

不涉及

unlimit

Integer

参数解释:

不限量套餐

约束限制:

不涉及

取值范围:

0-非不限量 1-不限量

默认取值:

不涉及

properties

Object

参数解释:

扩展字段

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

basePackageId

String

参数解释:

对应基础包id

约束限制:

当packageType为4或5时,需要填,其余不填

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

code

String

状态码

msg

String

状态描述

data

Array of BatchOperationInfo objects

反向通知响应数据

表6 BatchOperationInfo

参数

参数类型

描述

batchSN

String

批量操作流水号

operationList

Array of OperationResultInfo objects

批量操作数据(当前list限制最多50个元素,可配置)

表7 OperationResultInfo

参数

参数类型

描述

operationSN

String

操作流水号

carrierUserId

String

运营商用户id

kdUserId

String

koodrive内部用户Id

packageChangeList

Array of PackageChangeInfo objects

套餐修改动作集,限制1个元素

status

Integer

操作结果

-0:操作中;

-1:成功

-2:失败

errorCode

String

错误码,当操作失败时返回

errorMsg

String

错误信息,当操作失败时返回

表8 PackageChangeInfo

参数

参数类型

描述

changeType

Integer

参数解释:

变更类型

约束限制:

不涉及

取值范围:

1:订购

默认取值:

不涉及

packageId

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

packageType

Integer

参数解释:

套餐类型

约束限制:

当packageId字段传入时,该字段必传

取值范围:

-2:连续包月基础套餐

-3:连续包年基础套餐

-4:基于基础套餐的扩容包

-5:单独的扩容包

默认取值:

不涉及

capacity

Integer

参数解释:

套餐容量

约束限制:

当packageId字段传入时,该字段必传

取值范围:

单位KB

默认取值:

不涉及

activateTime

String

参数解释:

激活时间, ISO 标准时间格式

约束限制:

changeType=1时候必填,需要在当前计费周期内;changeType=0时非必填

取值范围:

不涉及

默认取值:

不涉及

packageName

String

参数解释:

套餐名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

status

String

参数解释:

套餐状态

约束限制:

不涉及

取值范围:

0-下线;1-发布

默认取值:

不涉及

price

String

参数解释:

套餐价格

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

promotionPrice

String

参数解释:

套餐折扣价

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

countryCode

String

参数解释:

国家/地区代码,参照ISO 3166-1 alpha-3

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

currencyCode

String

参数解释:

货币代码,参照ISO 4217标准

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

count

Integer

参数解释:

订购数量

约束限制:

不涉及

取值范围:

不涉及

默认取值:

1

channel

String

参数解释:

渠道字段,

约束限制:

不涉及

取值范围:

要求以 00、01、02 或 03 开头,后跟任意6个字符(总共8个字符)

默认取值:

不涉及

unlimit

Integer

参数解释:

不限量套餐

约束限制:

不涉及

取值范围:

0-非不限量 1-不限量

默认取值:

不涉及

properties

Object

参数解释:

扩展字段

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

basePackageId

String

参数解释:

对应基础包id

约束限制:

当packageType为4或5时,需要填,其余不填

取值范围:

不涉及

默认取值:

不涉及

请求示例

反向通知请求参数

{
  "operationList" : [ {
    "operationSN" : "string",
    "carrierUserId" : "string",
    "packageChangeList" : [ {
      "changeType" : 0,
      "packageId" : "string",
      "packageType" : 0,
      "capacity" : 0,
      "count" : 0,
      "channel" : "string",
      "unlimit" : 0,
      "properties" : { },
      "activateTime" : "2025-09-18T06:14:54.620Z",
      "endTime" : "2025-09-18T06:14:54.620Z",
      "packageName" : "string",
      "basePackageId" : "string",
      "status" : "string",
      "price" : "string",
      "promotionPrice" : "string",
      "countryCode" : "string",
      "currencyCode" : "string"
    } ]
  } ],
  "batchSN" : "string",
  "assetClearPolicy" : 0
}

响应示例

状态码:200

运营商反向通知响应体

{
  "code" : "stringst",
  "msg" : "string",
  "data" : [ {
    "batchSN" : "string",
    "operationList" : [ {
      "operationSN" : "string",
      "carrierUserId" : "string",
      "packageChangeList" : [ {
        "changeType" : 0,
        "packageId" : "string",
        "packageType" : 0,
        "capacity" : 0,
        "count" : 0,
        "channel" : "string",
        "unlimit" : 0,
        "properties" : { },
        "activateTime" : "2025-09-18T06:37:17.549Z",
        "endTime" : "2025-09-18T06:37:17.549Z",
        "packageName" : "string",
        "basePackageId" : "string",
        "status" : "string",
        "price" : "string",
        "promotionPrice" : "string",
        "countryCode" : "string",
        "currencyCode" : "string"
      } ],
      "kdUserId" : "string",
      "status" : 0,
      "errorCode" : "string",
      "errorMsg" : "string"
    } ]
  } ]
}

状态码

状态码

描述

200

运营商反向通知响应体