遍历业务
-
请求地址：
GET /businesses -
接口概述：
遍历业务数据。
-
请求参数：
参数名 参数类型 参数说明 必需 备注 offset integer 响应结果起始下标 否 默认0 limit integer 响应结果的数量 否 默认50，最大1000 -
请求体：
无
-
请求示例：
GET /bitanswer/api/businesses?limit=1 HTTP/1.1 Host: back-office-api.bitanswer.cn bitkey: •••••• -
响应示例：
{ "status": 0, "data": { "total": 5, "items": [ { "guid": "xxx", "name": "foo", "type": "FLOAT", "description": "boo" } ] } }
查询业务
-
请求地址：
POST /businesses/data -
接口概述：
根据指定条件查询业务。
-
请求参数：
参数名 参数类型 参数说明 必需 备注 offset integer 响应结果起始下标 否 默认0 limit integer 响应结果的数量 否 默认50，最大1000 -
请求体：
参数名 参数类型 参数说明 必需 备注 querys array 查询参数 否 sorts array 排序参数 否 querys
支持：
name，guid，type。sorts
支持：
name。 -
请求示例：
POST /bitanswer/api/businesses/data HTTP/1.1 Host: back-office-api.bitanswer.cn Content-Type: application/json bitkey: •••••• { "querys": [ { "name": "name", "op": "=", "values": [ "Test" ] } ], "sorts": [ { "name": "name" } ] } -
响应示例：
{ "status": 0, "data": { "total": 1, "items": [ { "guid": "xxx", "name": "foo", "type": "GROUP" } ] } }
添加业务
-
请求地址：
POST /businesses -
接口概述：
添加业务数据（该接口不支持创建帐号授权2.0业务）。
-
请求参数：
无
-
请求体：
参数名 参数类型 参数说明 必需 备注 name string 业务名称 是 业务名称不能超过64个字符 businessOs string 业务操作系统 是 业务操作系统： DEFAULT：全平台，WINDOWS，PC_LINUX，MACOS，ANDROID，ARM_LINUX，IOS，MIPS，Linux，UNIX，QNX，HARMONYtype string 业务类型 是 业务类型： CLOUD：云，WEB_APP：帐号授权，LOCAL：单机，FLOAT：单机浮动，GROUP：集团授权，BIT_ID，BIT_ID_FLOAT：Bit-ID浮动授权，BIT_ID_GROUP：Bit-ID集团，DEMO：演示，TRY：试用，PRE：预授权，USB：U盘授权，BATCH：批量授权，ANDROID：安卓授权description string 业务说明 否 controlType string 授权方式 否 授权方式： ONLINE：在线，OFFLINE：离线，SMART：智能volumeNumber integer 终端限制 否 startDate string 起始日期否 否 yyyy-MM-dd HH:mm:ssendDate string 结束日期 否 yyyy-MM-dd HH:mm:ssexpirationDays integer 有效期 否 usageNumber integer 使用次数 否 concurrentNumber integer 并发数 否 usersNumber integer 用户数 否 maxOfflineMinutes integer 强制认证 否 maxTotalMinutes integer 运行时间 否 downloadNumber integer 安装限制 否 transferVolume integer 浮动机器 否 transferNumber integer 转移次数 否 vmDetect boolean 虚拟机检测 否 forbidRemoteDesktop boolean 远程桌面检测 否 licenseBorrow boolean 授权借出 否 earlyReturn boolean 提前返还 否 redundant boolean 冗余检查 否 mute boolean 不可升级 否 preClient boolean 设备有效期 否 preLicense boolean 预授权 否 localOnly boolean 仅限本机访问 否 denyActivation boolean 阻止新激活 否 namedUser boolean 帐号授权 否 accessLog boolean 用量统计 否 distribution boolean 授权分发 否 agent boolean 多级服务 否 ignoreUserLimit boolean 忽略用户数 否 allReUpdate boolean 重用升级码 否 readonly boolean 授权只读 否 uploadPeak boolean 峰值上传 否 allowSplit boolean 允许拆分 否 denyContainer boolean 容器检测 否 bindingBitId boolean 绑定比特ID 否 -
请求示例：
POST /bitanswer/api/businesses?limit=1 HTTP/1.1 Host: back-office-api.bitanswer.cn bitkey: •••••• { "name":"demo_business", "businessOs":"WINDOWS", "type":"CLOUD", "description": "This is description." } -
响应示例：
{ "status": 0, "data": { "total": 1, "items": [ { "controlType": "ONLINE", "concurrentNumber": 1, "usersNumber": 1, "transferVolume": 0, "transferNumber": 0, "guid": "xxxxxxxxxx", "name": "demo_business", "type": "CLOUD", "businessOs": "WINDOWS", "description": "This is description.", "regDate": "2025-09-18 16:44:04" } ] } }
查询指定业务
-
请求地址：
GET /businesses/{businessName} -
接口概述：
查询指定业务的信息。
-
请求参数：
地址参数
参数名 参数类型 参数说明 必需 备注 businessName string 业务名 是 -
请求体：
无
-
请求示例：
GET /bitanswer/api/businesses/{businessName} HTTP/1.1 Host: back-office-api.bitanswer.cn bitkey: •••••• -
响应示例：
{ "status": 0, "data": { "total": 1, "items": [ { "controlType": "ONLINE", "concurrentNumber": 1, "usersNumber": 1, "transferVolume": 0, "transferNumber": 0, "guid": "xxxxxxxxxx", "name": "demo_business", "type": "CLOUD", "businessOs": "WINDOWS", "description": "This is description.", "regDate": "2025-09-18 16:44:04" } ] } }
按业务名更新业务
-
请求地址：
-
PATCH /businesses/{businessName} -
POST /businesses/{businessName}
-
-
接口概述：
通过地址参数上的业务名查询指定产品，修改业务的信息。
PATCH 方法用于部分更新数据，仅对请求中明确输入的内容进行修改，其他内容保持原有值不变。
POST 方法用于全量重置数据，会以请求中输入的内容覆盖原有值，未输入内容则被置为空值。（不推荐用于部分更新数据，易导致未输入数据被误清空）
-
请求参数：
地址参数
参数名 参数类型 参数说明 必需 备注 businessName string 业务名 是 -
请求体：
参数名 参数类型 参数说明 必需 备注 name string 业务名称 否 业务名称不能超过64个字符 description string 业务说明 否 controlType string 授权方式 否 授权方式： ONLINE：在线，OFFLINE：离线，SMART：智能volumeNumber integer 终端限制 否 startDate string 起始日期否 否 yyyy-MM-dd HH:mm:ssendDate string 结束日期 否 yyyy-MM-dd HH:mm:ssexpirationDays integer 有效期 否 usageNumber integer 使用次数 否 concurrentNumber integer 并发数 否 usersNumber integer 用户数 否 maxOfflineMinutes integer 强制认证 否 maxTotalMinutes integer 运行时间 否 downloadNumber integer 安装限制 否 transferVolume integer 浮动机器 否 transferNumber integer 转移次数 否 vmDetect boolean 虚拟机检测 否 forbidRemoteDesktop boolean 远程桌面检测 否 licenseBorrow boolean 授权借出 否 earlyReturn boolean 提前返还 否 redundant boolean 冗余检查 否 mute boolean 不可升级 否 preClient boolean 设备有效期 否 preLicense boolean 预授权 否 localOnly boolean 仅限本机访问 否 denyActivation boolean 阻止新激活 否 namedUser boolean 帐号授权 否 accessLog boolean 用量统计 否 distribution boolean 授权分发 否 agent boolean 多级服务 否 ignoreUserLimit boolean 忽略用户数 否 allReUpdate boolean 重用升级码 否 readonly boolean 授权只读 否 uploadPeak boolean 峰值上传 否 allowSplit boolean 允许拆分 否 denyContainer boolean 容器检测 否 bindingBitId boolean 绑定比特ID 否 -
请求示例：
PATCH /bitanswer/api/businesses/{businessName} HTTP/1.1 Host: back-office-api.bitanswer.cn bitkey: •••••• { "name": "new_business_name", "description": "修改描述" } -
响应示例：
{ "status": 0, "data": { "total": 1, "items": [ { "controlType": "ONLINE", "concurrentNumber": 1, "usersNumber": 1, "transferVolume": 0, "transferNumber": 0, "guid": "xxxxxxxxxx", "name": "new_business_name", "type": "CLOUD", "businessOs": "WINDOWS", "description": "修改描述", "regDate": "2025-09-18 16:44:04" } ] } }
按业务名删除业务
-
请求地址：
DELETE /businesses/{businessName} -
接口概述：
删除指定名称的业务。业务下存在SN时删除会报错。
-
请求参数：
地址参数
参数名 参数类型 参数说明 必需 备注 businessName string 业务名 是 -
请求体：
无
-
请求示例：
DELETE /bitanswer/api/businesses/{businessName} HTTP/1.1 Host: back-office-api.bitanswer.cn bitkey: •••••• -
响应示例：
{ "status": 0, "data": { "total": 1, "items": [ { "name": "demo_business" } ] } }