admin9webs
322b7737eb
来源：紫鸟帮助中心/博客/主站资讯 + HubStudio API 文档/帮助中心 + 三个官方 skill 仓库。 只入库 Markdown 与元数据；原始 HTML 与 tarball 留在本机。
135 lines
4.8 KiB
Markdown
135 lines
4.8 KiB
Markdown
# 账号增删改查与状态接口
|
||
|
||
> 本文件是 ziniao-erp-api-doc 的 Level 2 参考文档。
|
||
> 仅在需要查阅账号创建、删除、编辑、列表查询、标签列表、缓存清除接口的详细参数时加载。
|
||
|
||
---
|
||
|
||
## ERP-创建账号
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/store/create` **方法**：POST **权限点**：ERP-创建与删除账号权限
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
| storeData | 账号数据数组 | 是 | array |
|
||
| storeData[].name | 账号名 | 是 | string |
|
||
| storeData[].username | 平台登录账号 | 否 | string |
|
||
| storeData[].password | 平台登录密码 | 否 | string |
|
||
| storeData[].siteId | 站点id | 否 | string |
|
||
| storeData[].tagIds | 标签列表（不超过5个） | 否 | number[] |
|
||
| proxyId | 设备id | 否 | number |
|
||
| enterpriseName | 企业简称 | 否 | string |
|
||
| defyWarning | 是否无视风险添加：1是 0否（默认1） | 否 | string |
|
||
|
||
**响应 data**：数组，每项含 storeId(string)、name(string)、siteId(string)、msg(string)、riskMsgList(string[])
|
||
|
||
---
|
||
|
||
## ERP-删除账号
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/store/delete` **方法**：POST **权限点**：ERP-创建与删除账号权限
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
| storeIds | 账号id数组 | 是 | number[] |
|
||
|
||
**响应**：ret / status / msg
|
||
|
||
---
|
||
|
||
## ERP-编辑账号基础信息
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/store/update/base` **方法**：POST **权限点**：ERP-编辑账号基础信息
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
| id | 账号id | 是 | number |
|
||
| name | 账号名（≤64位，不传不更新） | 否 | string |
|
||
| siteId | 平台id（不传不更新） | 否 | number |
|
||
| tagIds | 标签id列表（不传不更新，传空清空，≤5个） | 否 | number[] |
|
||
| defyWarning | 是否无视风险：1是 0否（默认1） | 否 | integer |
|
||
| customerUrl | 自定义平台站点url | 否 | string |
|
||
|
||
**响应**：ret / msg / status
|
||
|
||
---
|
||
|
||
## ERP-账号列表查询
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/store/list` **方法**：POST **权限点**：ERP-账号查看权限
|
||
|
||
> 私有化账号建议一次最多查询 20 条。
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
| storeName | 账号名称 | 否 | string |
|
||
| ip | 设备ip | 否 | string |
|
||
| page | 页码 | 否 | number |
|
||
| limit | 每页条数 | 否 | number |
|
||
|
||
**响应 data**：数组，每项含 id、name、ip、proxyId、siteId、siteName、platform、platformName、username、createtime、lastuserId、lastusetime、packageName (均 string)。另有 count。
|
||
|
||
---
|
||
|
||
## ERP-用户的账号列表查询
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/store/list/by/user` **方法**：POST **权限点**：ERP-账号查看权限
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
| userId | 用户id | 是 | number |
|
||
| storeName | 账号名称 | 否 | string |
|
||
| page | 页码 | 否 | number |
|
||
| limit | 每页条数 | 否 | number |
|
||
|
||
**响应 data**：数组，每项含 storeId、storeName、proxyId、ipExpiryTime、platformName (均 string)。另有 count。
|
||
|
||
---
|
||
|
||
## ERP-查询某用户有权限的账号列表
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/user/stores` **方法**：POST **权限点**：ERP-查询某用户有权限的账号列表
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
| userId | 用户id | 是 | number |
|
||
| storeName | 账号名称 | 否 | string |
|
||
| isAccurate | 0模糊 1精确（默认精确） | 否 | number |
|
||
| page | 页码 | 否 | number |
|
||
| limit | 每页条数 | 否 | number |
|
||
|
||
**响应 data**：数组，每项含 id(number)、name、ipId(number)、ip、platform、platformCategory、userName、lastUserId、lastUserName、lastOpenUsername、lastUsetime、ipExpiryTime、tags(string[])、regionInfo。另有 count。
|
||
|
||
---
|
||
|
||
## ERP-标签列表
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/tag/list` **方法**：POST **权限点**：ERP-标签列表
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
|
||
**响应 data**：对象，含 list 数组，每项含 id(string)、name(string)。
|
||
|
||
---
|
||
|
||
## ERP-清除账号缓存
|
||
|
||
- **路径**：`/superbrowser/rest/v1/erp/store/deletecookie` **方法**：POST **权限点**：ERP-清除账号缓存
|
||
|
||
| 参数 | 说明 | 必须 | 类型 |
|
||
|------|------|------|------|
|
||
| companyId | 公司id | 是 | number |
|
||
| userId | 用户id | 是 | string |
|
||
| removeStoreId | 账号id | 是 | number |
|
||
| removeType | 1清除所有 2仅保留cookie 3仅保留二步验证状态 | 是 | number |
|
||
|
||
**响应**：ret / msg / status
|