更新客户权益
1. 接口描述
接口名称：
/eventopenapi/gnet/wps/order/update
发送方式：
POST
参数格式：
accept: application/json;content-type: application/json
2. 输入参数
Http Headers
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| token | String | 是 | 请求参数， 使用开发者秘钥生成 |
Http Body
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| orderId | String | 是 | 第三方订单ID |
| salesInfo | JSON | 否 | 基础销售品信息 |
| attachment | JSON | 否 | 增值权益项开通列表， salesInfo , attachment同时为空时返回错误 |
| callbackUrl | String | 是 | 第三方回调地址 |
salesInfo 参数说明
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| productType | Int | 否 | 基础产品类型, 1:标准全时云会议 2:公共会议室 |
| endTime | 时间戳 | 否 | 基础包截止时间，精确到秒, 如果productType, endTime不为空， 调整基础包的截止时间 |
attachment 参数说明
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| liveService | JSON | 否 | 直播会议权益 |
| rooms | JSON | 否 | rooms权益 |
| chinaTelephone | JSON | 否 | 国内电话权益 |
| mtgHub | JSON | 否 | mtgHub权益 |
| hardwareVideo | JSON | 否 | 硬件视频权益 |
| aiSpeakWorld | JSON | 否 | 同声传译权益 |
| overseasSpeedUp | JSON | 否 | 海外加速权益 |
liveService
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | Int | 否 | 直播总流量, 单位kb |
| usage | Int | 否 | 直播消耗量, 单位kb |
| endTime | 时间戳 | 否 | 权益失效时间，精确到秒 |
chinaTelephone
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | Int | 否 | 电话包分钟数, 单位分钟 |
| usage | Int | 否 | 电话使用量, 单位分钟 |
| endTime | 时间戳 | 否 | 权益失效时间，精确到秒 |
mtgHub
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | Int | 否 | mtgHub入会总分钟数 |
| usage | Int | 否 | mtgHub入会使用量,单位分钟 |
| endTime | 时间戳 | 否 | 权益失效时间,精确到秒 |
hardwareVideo
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | Int | 否 | 硬件视频最大并发数 |
| endTime | 时间戳 | 否 | 权益失效时间，精确到秒 |
rooms
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | Int | 否 | rooms个数 |
| endTime | 时间戳 | 否 | 权益失效时间，精确到秒 |
overseasSpeedUp
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | Int | 否 | 海外加速总时间数， 单位分钟 |
| usage | Int | 否 | 海外加速使用量 单位分钟 |
| endTime | 时间戳 | 否 | 权益失效时间，精确到秒 |
aiSpeakWorld
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| number | Int | 否 | 同声传译总时间数, 单位分钟 |
| usage | Int | 否 | 同声传译使用量 单位分钟 |
| endTime | 时间戳 | 否 | 权益失效时间，精确到秒 |
更新示例
{
"orderId":"314c6deb-ca7b-43eb-96fb-791523843704",
"salesInfo":{
"productType":1,
"endTime":1765267113,
},
"attachment":{
"liveService":{
"number":2000,
"usage":1000,
"endTime":1765267113,
},
"chinaTelephone":{
"number":2000,
"usage":1000,
"endTime":1765267113,
},
"hardwareVideo":{
"number":2000,
"endTime":1765267113,
},
"mtgHub":{
"number":2000,
"usage":1000,
"endTime":1765267113,
},
"rooms":{
"number":5,
"endTime":1765267113,
},
"overseasSpeedUp":{
"number":50000,
"usage":1000,
"endTime":1765267113,
},
"aiSpeakWorld":{
"number":50000,
"usage":1000,
"endTime":1765267113,
}
}
"callbackUrl":"http://www.sohu.com"
}
3. 输出参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 返回的状态码， 200成功 |
| msg | String | 当返回结果的状态码不为200时，包含的错误信息 |
| data | Json | - |
| timeStamp | Long | 返回时间（时间戳，单位毫秒） |
| requestId | String | 请求ID（在接口异常时, 需提供请求ID） |
data 参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| orderId | String | 订单ID |
| orderStatus | Int | 订单处理结果, 1:订单处理中 2:订单处理成功 3:订单处理失败 |
- 接口调用成功，返回状态1
- 接口调用如果有参数错误，或其他错误， 返回 3
- 回调中返回2和3两种状态
示例
输出示例
{
"code": 200,
"data": {
"orderId": "10390333",
"orderStatus": 1
},
"msg": "success",
"requestId": "23-233",
"timeStamp": 10233333
}
4. 回调
全时执行完业务逻辑后， 通过回调接口, 通知金山结果
| 参数 | 类型 | 说明 |
|---|---|---|
| orderId | String | 订单ID |
| orderStatus | Int | 订单处理结果, 1:订单处理中 2:订单处理成功 3:订单处理失败 |
| msg | String | 消息 |
请求示例
{
"orderId": "asdasdasdas24234",
"orderStatus": 2,
"msg":"failed because ....."
}
