browser-docs-archive/repos/skill-hub/skills/ziniao-erp-api-doc/reference/device-management.md

设备管理接口

本文件是 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