添加订单

1. 接口描述

接口名称:

/eventopenapi/gnet/wps/order/add

发送方式:

POST

参数格式:

accept: application/json;content-type: application/json

2. 输入参数

Http Headers

参数 类型 必须 说明
Nonce String 随机数(随机数,最大长度128个字符)
CurTime String 当前UTC时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
CheckSum String 服务器认证需要,16进制字符小写SHA1(AppSecret+Nonce+CurTime), AppSecret由全时分配, 如果CheckSum值不一致, 不允许请求接口

Http Body

参数 类型 必须 说明
customerInfo Object 客户基本信息
salesInfo Object 基础销售品信息
attachment JSON 增值权益项开通列表
orderId String 第三方订单ID
callbackUrl String 第三方回调地址
meetingCallbackUrl String 会议回调地址

customerInfo 参数说明

参数 类型 必须 说明
customerName String 客户名称,customerCode,customerName 二选一,当全时不存在该企业时, 必须提供客户名称
thirdPartnerId Long 第三方客户ID
customerCode String 全时客户ID,如果是全时已存在客户,请通过销售获得全时客户ID

salesInfo 参数说明

参数 类型 必须 说明
productType Int 基础产品类型, 1:标准全时云会议 2:公共会议室
endTime 时间戳 基础包截止时间,精确到秒

attachment 参数说明

参数 类型 必须 说明
liveService JSON 直播会议权益
rooms JSON rooms权益
chinaTelephone JSON 国内电话权益
mtgHub JSON mtgHub权益
hardwareVideo JSON 硬件视频权益

liveService

参数 类型 必须 说明
packageNumber Int 流量包个数, 一个流量包xTB
endTime 时间戳 权益失效时间,精确到秒

chinaTelephone

参数 类型 必须 说明
packageNumber Int 电话流量包个数, 一个流量包x分钟
endTime 时间戳 权益失效时间,精确到秒

mtgHub

参数 类型 必须 说明
totalMinutes Int mtgHub入会总分钟数
endTime 时间戳 权益失效时间,精确到秒

rooms

参数 类型 必须 说明
number Int rooms个数
endTime 时间戳 权益失效时间,精确到秒

hardwareVideo

参数 类型 必须 说明
portNumber Int 硬件视频最大并发数
endTime 时间戳 权益失效时间,精确到秒

购买标准产品示例

{
    "orderId":"314c6deb-ca7b-43eb-96fb-791523843704",
    "productType" : 1,
    "customerInfo":{
        "customerName":"test",
        "thirdPartnerId":"12987",
        "customerCode":""
    },
    "salesInfo":{
        "productType":1,
        "endTime":1765267113,
    },
    "attachment":{
            "liveService":{
                "packageNumber":2,
                "endTime":1765267113,
            },
            "rooms":{
                "number":5,
                "endTime":1765267113,
            },
            "chinaTelephone":{
                "packageNumber":2000,
                "endTime":1765267113,
            },
            "hardwareVideo":{
                "portNumber":2000,
                "endTime":1765267113,
            },
            "mtgHub":{
                "totalMinutes":2000,
                "endTime":1765267113,
            }
        }
    "callbackUrl":"http://www.sohu.com",
    "meetingCallbackUrl":"http://www.kdoc.doc.cn/meeting"

}

3. 输出参数

参数 类型 说明
timeStamp Long 返回时间(时间戳,单位毫秒)
requestId String 请求ID(在接口异常时, 需提供请求ID)
code Int 返回的状态码
msg String 当返回结果的状态码不为200时,包含的错误信息
data Json -

data 参数说明

参数 类型 说明
orderId String 订单ID
status Int 订单处理结果, 1:订单处理中 2:订单处理成功 3:订单处理失败
  • 接口调用成功,返回状态1
  • 接口调用如果有参数错误,或其他错误, 返回 3
  • 回调中返回2和3两种状态

示例

输出示例

{
  "orderId": "10390333",
  "status":1  
}

4. 回调

全时执行完业务逻辑后, 通过回调接口, 通知金山结果

参数 类型 说明
orderId String 订单ID
orderStatus int 订单处理结果, 1:成功, 0:失败
appId String 全时开发者秘钥
appSecret String 全时开发者秘钥
customerCode String 全时客户编码
failedReason String 消息

输出示例

{
  "companyId": 683098735,
  "orderId": "asdasdasdas24234",
  "appId": "b70847a3d2b78ff4b4b7ed1ab487fbfd",
  "orderStatus": 1,
  "customerCode": "0012345",
  "appSecret": "69be63149dbf6e98cc933dcd8895f273"
}