Skip to content
ziniao-openapi-explorer logo

API 探索

ziniao-openapi-explorer

紫鸟 API 探索:当现有快捷命令无法满足需求时,通过通用 api 命令和已知路径清单探索紫鸟全部 73 个 API 接口。

ziniao-open/skills5Kinstalls6stars

SKILL.md

Full skill instructions

API 探索

前置条件: 先阅读 ../​ziniao-shared/​SKILL.md。

当用户的需求无法被现有快捷命令覆盖时,使用本技能查找对应的 API 路径并通过 ziniao-cli api 裸调。

探索流程

Step 1: 确认现有命令不足

ziniao-cli department --help
ziniao-cli staff --help
ziniao-cli account --help
ziniao-cli device --help
ziniao-cli role --help

如果已有对应快捷命令,直接使用。

Step 2: 从路径清单定位 API

禁止猜测 API 路径,必须从以下清单中查找。

部门(5 个)✅ 全部已有快捷命令
操作路径快捷命令
列表/​superbrowser/​rest/​v1/​erp/​department/​listdepartment list
新增/​superbrowser/​rest/​v1/​erp/​department/​adddepartment create
修改/​superbrowser/​rest/​v1/​erp/​department/​updatedepartment update
删除/​superbrowser/​rest/​v1/​erp/​department/​deletedepartment delete
排序/​superbrowser/​rest/​v1/​erp/​department/​orderdepartment reorder
员工(5 个)✅ 全部已有快捷命令
操作路径快捷命令
列表/​superbrowser/​rest/​v1/​erp/​staff/​liststaff list
新增/​superbrowser/​rest/​v2/​erp/​staff/​addstaff create
修改/​superbrowser/​rest/​v2/​erp/​staff/​modifystaff update
状态/​superbrowser/​rest/​v1/​erp/​staff/​statusstaff enable/​disable/​remove
调岗/​superbrowser/​rest/​v1/​erp/​staff/​departmentstaff transfer
账号(23 个)— 仍有 4 个需用 api
分类路径前缀快捷命令
CRUD/​superbrowser/​rest/​v1/​erp/​store/​list|create|update/​base|deleteaccount list/​create/​update/​delete
缓存/​superbrowser/​rest/​v1/​erp/​store/​deletecookieapi
授权/​superbrowser/​rest/​v1/​erp/​store/​auth/​add|delete|clean、/​superbrowser/​rest/​v1/​erp/​user/​stores、/​superbrowser/​rest/​v1/​erp/​store/​user/​listaccount auth-*
授权查询/​superbrowser/​rest/​v1/​erp/​store/​auth/​queryapi
用户账号/​superbrowser/​rest/​v1/​erp/​store/​list/​by/​userapi
附加信息/​superbrowser/​rest/​v1/​erp/​store/​addtionapi
标签/​superbrowser/​rest/​v1/​erp/​tag/​list、/​superbrowser/​rest/​v1/​store-tag/​add|delete|rename|bind|unbind|replace|clear|remove|listaccount tag-*
设备(11 个)— 仍有 2 个需用 api
分类路径前缀快捷命令
查询/​superbrowser/​rest/​v1/​erp/​ip/​page、/​superbrowser/​rest/​v1/​erp/​proxy/​purchased_package_info、/​superbrowser/​rest/​v1/​erp/​ip/​historybinddevice list(price/​history 用 api)
套餐/​superbrowser/​rest/​v1/​erp/​package/​newdevice plan-list
购买/​superbrowser/​rest/​v1/​erp/​purchase|renewdevice purchase/​renew
自有/​superbrowser/​rest/​v1/​erp/​ip/​self/​add/​new|edit/​newdevice add-custom/​update-custom
绑定/​superbrowser/​rest/​v1/​erp/​ip/​bind|unbind|renewaldevice bind/​unbind/​auto-renew
角色(7 个)✅ 全部已有快捷命令
操作路径快捷命令
列表/​superbrowser/​rest/​v1/​erp/​per/​role/​listrole list
详情/​superbrowser/​rest/​v1/​erp/​per/​role/​detailrole detail
新增/​superbrowser/​rest/​v1/​erp/​per/​role/​addrole create
修改/​superbrowser/​rest/​v1/​erp/​per/​role/​editrole update
分配/​superbrowser/​rest/​v1/​erp/​staff/​change/​rolerole assign
用户角色/​superbrowser/​rest/​v1/​erp/​staff/​role/​listrole staff-roles
权限列表/​superbrowser/​rest/​v1/​erp/​per/​permission/​listrole permissions
访问策略(22 个)— 全部需用 api
分类路径
规则/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​list
规则/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​detail
规则/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​add
规则/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​edit
规则/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​delete
规则/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​active
规则成员/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​change_user
规则账号/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​change_account
规则账号/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​account/​bindable_list
网页/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url/​list
网页/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url/​detail
网页/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url/​add
网页/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url/​edit
网页/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url/​delete
网页/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url/​change_group
网页分组/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url_group/​list
网页分组/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url_group/​add
网页分组/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url_group/​edit
网页分组/​superbrowser/​rest/​v1/​erp/​security/​access_rule_url_group/​delete
账号策略/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​list/​one_account
账号策略/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​account_ref/​add_to_account
账号策略/​superbrowser/​rest/​v1/​erp/​security/​access_rule/​account_ref/​remove_from_account

Step 3: 使用 dry-run 探索

# 先预览请求
ziniao-cli api /​superbrowser/​rest/​v1/​erp/​per/​role/​list --dry-run

# 确认后执行
ziniao-cli api /​superbrowser/​rest/​v1/​erp/​per/​role/​list

安全规则

  • 禁止猜测 API 路径或参数,必须从清单中查找
  • 写入/删除类操作前确认用户意图
  • 建议先用 --dry-run 预览

参考

More skills from ziniao-open

ziniao-role logo
ziniao-open/skills

ziniao-role

紫鸟角色管理:角色的查询、创建、修改、分配和权限查看。当用户需要查看角色列表、创建/修改角色、将角色分配给员工或查看角色成员时使用。

6 4.9K
View
ziniao-skill-maker logo
ziniao-open/skills

ziniao-skill-maker

创建 ziniao-cli 的自定义 Skill。当用户需要把紫鸟 API 操作封装成可复用的 Skill(包装原子 API 或编排多步流程)时使用。

6 4.9K
View
ziniao-device logo
ziniao-open/skills

ziniao-device

紫鸟设备管理:代理设备(IP)的查询、添加、修改、绑定/解绑、购买续费和自动续费。当用户需要查看代理设备列表、添加/修改自有代理、绑定设备到店铺或管理设备费用时使用。

6 4.9K
View
ziniao-access-policy logo
ziniao-open/skills

ziniao-access-policy

紫鸟访问策略管理:网页访问规则、网页/网页分组、规则生效成员/账号、账号绑定策略的查询和维护。当前无快捷命令,全部通过 ziniao-cli api 直调。

6 4.9K
View
ziniao-department logo
ziniao-open/skills

ziniao-department

紫鸟部门管理:部门的查询、创建、修改、删除和排序。当用户需要查看组织架构、创建/修改/删除部门、调整部门排序时使用。

6 4.9K
View

批量账号授权工作流:编排 account list + staff list + api 调用完成批量授权店铺给员工。适用于新员工入职时批量分配店铺权限。

6 4.9K
View
ziniao-account logo
ziniao-open/skills

ziniao-account

紫鸟账号(店铺)管理:店铺账号的查询、创建、修改、删除、授权和标签管理。当用户需要查看店铺账号列表、创建/修改/删除账号、管理账号授权或标签时使用。

6 4.9K
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View