archive: 紫鸟/HubStudio 文档快照（3889 篇 Markdown）
来源：紫鸟帮助中心/博客/主站资讯 + HubStudio API 文档/帮助中心 + 三个官方 skill 仓库。 只入库 Markdown 与元数据；原始 HTML 与 tarball 留在本机。
This commit is contained in:
admin9webs committed
commit
322b7737eb
3976 files changed
+695714
No files matched your search
@@ -0,0 +1,180 @@
|
||||
# 设备管理接口
|
||||
|
||||
> 本文件是 ziniao-erp-api-doc 的 Level 2 参考文档。
|
||||
> 仅在需要查阅设备套餐、购买、续费、绑定、解绑、查询、自有设备管理接口时加载。
|
||||
|
||||
所有接口方法均为 POST，Content-Type 为 application/json。
|
||||
|
||||
---
|
||||
|
||||
## ERP-套餐列表查询
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/package/new` **权限点**：ERP-设备套餐列表查询权限
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | number |
|
||||
|
||||
**响应 data**：数组，每项含 regionCloudId(套餐ID)、ctype(0站群/1云平台/2自有/3本地)、networkType、areaId、areaName、city、priceOriginal、deviceConfigName、deviceType(1标准/2节能/3高配)、deviceOs、deviceSupportRemoteLogin、deviceCpuSize、deviceMemorySize、deviceBandWidth、deviceDiskSize、platformName (均 string)。
|
||||
|
||||
---
|
||||
|
||||
## ERP-购买设备
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/purchase` **权限点**：ERP-设备购买与续费权限
|
||||
|
||||
> 需要紫鸟账号上有余额。
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | string |
|
||||
| purchase | 购买信息对象 | 是 | object |
|
||||
| purchase.packageId | 套餐id | 是 | number |
|
||||
| purchase.periodId | 时长id（1:1月/2:3月/3:6月/4:12月） | 是 | number |
|
||||
| purchase.num | 数量（单次最多5个） | 是 | number |
|
||||
| storeIds | 要绑定的账号id（未绑设备的） | 否 | number[] |
|
||||
|
||||
**响应 data**：含 order_id(string)、create_time(string)、proxyIdList(number[] 设备ID列表)。
|
||||
|
||||
---
|
||||
|
||||
## ERP-续费设备
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/renew` **权限点**：ERP-设备购买与续费权限
|
||||
|
||||
> 仅支持紫鸟 IP 续费；自有设备请通过开启自动续费。
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | string |
|
||||
| renew | 续费信息对象 | 是 | object |
|
||||
| renew.periodId | 时长id | 是 | string |
|
||||
| renew.ipIds | proxy_id 数组 | 是 | integer[] |
|
||||
|
||||
**响应 data**：含 id(设备id)、ip(设备ip)、expire(过期时间)。另有 orderId、createTime。
|
||||
|
||||
---
|
||||
|
||||
## ERP-开关自动续费
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/ip/renewal` **权限点**：ERP-开关自动续费
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | number |
|
||||
| ids | proxy_id 数组 | 是 | number[] |
|
||||
| isOpen | 0关闭 1开启 | 是 | number |
|
||||
|
||||
**响应**：ret / msg / status
|
||||
|
||||
---
|
||||
|
||||
## ERP-设备查询
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/ip/page` **权限点**：ERP-设备查询
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | number |
|
||||
| ipAddr | 设备地址 | 否 | string |
|
||||
| page | 页码 | 否 | string |
|
||||
| limit | 每页条数 | 否 | string |
|
||||
|
||||
**响应 data**：数组，每项含 id(number)、ip、proxyName、proxyType(0站群/1云平台/2自有/3vps/4虚拟机/5本地)、port、ptype(0http/1https/2socks5)、expiry、isRenewal(0关/1开)、createtime、delflag(0正常/2回收站) (均 string)。另有 count。
|
||||
|
||||
---
|
||||
|
||||
## ERP-绑定设备
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/ip/bind` **权限点**：ERP-设备绑定权限
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | number |
|
||||
| proxyId | 设备id | 是 | number |
|
||||
| storeIdList | 账号id列表 | 是 | number[] |
|
||||
| defyWarning | 是否无视风险：1是 0否（默认1） | 否 | number |
|
||||
|
||||
**响应**：ret / status / msg / riskMsgList(string[])
|
||||
|
||||
---
|
||||
|
||||
## ERP-解绑设备
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/ip/unbind` **权限点**：ERP-解绑设备
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | number |
|
||||
| storeId | 账号ID | 是 | number |
|
||||
|
||||
**响应**：ret / msg / status
|
||||
|
||||
---
|
||||
|
||||
## ERP-查询已购设备价格接口
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/proxy/purchased_package_info` **权限点**：ERP-查询已购设备价格接口
|
||||
|
||||
> 仅支持查询云平台设备。
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司ID | 是 | number |
|
||||
| proxyId | 设备ID | 是 | number |
|
||||
|
||||
**响应 data**：含 proxyId(number)、regionCloudId(number 套餐ID)、price(number 续费价格)。
|
||||
|
||||
---
|
||||
|
||||
## ERP-设备历史绑定记录
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/ip/historybind` **权限点**：ERP-设备查询
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司id | 是 | number |
|
||||
| proxyId | 设备id | 是 | number |
|
||||
|
||||
**响应 data**：对象含 list 数组，每项含 storeId、storeName、proxyName、unBindTime、unbindUserId、unbindUsername、cloudType (均 string)。另有 count。
|
||||
|
||||
---
|
||||
|
||||
## ERP-添加自有设备（新）
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/ip/self/add/new` **权限点**：ERP-添加自有设备（新）
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司ID | 是 | string |
|
||||
| defyWarning | 1无视风险 0风险提示 | 是 | number |
|
||||
| base | 基础信息对象 | 是 | object |
|
||||
| base.deviceName | 设备名称 | 是 | string |
|
||||
| base.isDynamic | 是否动态网络（false静态/true动态） | 是 | boolean |
|
||||
| proxy | 代理信息对象 | 是 | object |
|
||||
| proxy.type | 0http/1https/2sock5/3ssh/4ssl | 是 | string |
|
||||
| proxy.addr | 代理地址 | 是 | string |
|
||||
| proxy.port | 代理端口 | 是 | string |
|
||||
| proxy.username | 用户名 | 否 | string |
|
||||
| proxy.passwd | 密码 | 否 | string |
|
||||
| proxy.isSetAccount | 是否设密码 0否 1是 | 是 | number |
|
||||
|
||||
**响应 data**：含 id(number 设备ID)。
|
||||
|
||||
---
|
||||
|
||||
## ERP-修改自有设备信息（新）
|
||||
|
||||
- **路径**：`/superbrowser/rest/v1/erp/ip/self/edit/new` **权限点**：ERP-修改自有设备信息（新）
|
||||
|
||||
| 参数 | 说明 | 必须 | 类型 |
|
||||
|------|------|------|------|
|
||||
| companyId | 公司ID | 是 | string |
|
||||
| defyWarning | 1无视风险 0风险提示 | 是 | number |
|
||||
| proxyId | 设备ID | 是 | string |
|
||||
| base | 基础信息对象 | 是 | object |
|
||||
| base.deviceName | 设备名称（不传不更新） | 否 | string |
|
||||
| base.isDynamic | 是否动态网络 | 是 | boolean |
|
||||
| proxy | 代理信息对象（字段同添加接口） | 是 | object |
|
||||
|
||||
**响应**：ret / status / msg
|
||||
Reference in new issue
Block a user