用途:本 Skill 面向需要了解紫鸟单点登录 OpenAPI 能做什么、如何做 ERP SSO 集成设计或接口评估的场景。它说明整体定位与边界,不提供账号 CRUD、标签、授权、设备管理接口,也不提供浏览器自动化(RPA/脚本注入)能力;Schema URL 仅支持 Windows 客户端。查阅具体接口请求/响应参数时,应先按路由表读取 reference/ 下对应文件。
主要能力:围绕应用认证、企业信息、员工查询、账号查询、用户登录与客户端控制。认证支持简单鉴权(直接用 API Key,放入 Authorization: Bearer {API_Key} 请求头,无需调用 get_app_token)和复杂鉴权(需先调用 get_app_token 获取 appAuthToken);企业信息可获取 companyId;员工查询分页列出员工并支持按角色/状态/部门筛选;账号查询可查全部账号或指定用户有权限的账号;用户登录获取 openapiToken 用于 SSO 鉴权;客户端控制通过 superbrowser:// Schema URL 的 OpenStrore、CloseStrore、exit 打开/关闭账号或退出浏览器。
使用方式:典型 SSO 流程为——在开放平台创建自建应用获取 API Key;调用 builtin/company 获取 companyId;调用 staff/list 获取 userId;调用 user/stores 获取 storeId;调用 user-login 获取 openapiToken(需提前申请权限);拼接 superbrowser://OpenStrore?storeId={storeId}&openapiToken={token}&userId={userId} 拉起浏览器。复杂鉴权模式需额外调用 get_app_token。Base URL 为 https://sbappstoreapi.ziniao.com/openapi-router,请求编码 UTF-8,Content-Type 为 application/json;需在开放平台创建“卖家自研应用”、申请权限点并配置 IP 白名单;user-login 接口需联系紫鸟客服申请权限(需 Boss 验证)。
关键约束:所有接口返回双层嵌套结构,解析时先剥离网关层再读业务层;异常时需打印 request_id、msg 和 sub_msg。接口分组涵盖认证、企业、员工、账号、登录,路径包括 /auth/get_app_token、/app/builtin/company、/superbrowser/rest/v1/erp/staff/list、/superbrowser/rest/v1/erp/store/list、/superbrowser/rest/v1/erp/user/stores、/superbrowser/rest/v1/token/user-login。按需深入时,认证参数读 reference/account-auth.md,企业/员工/账号参数读 reference/account-crud.md,Schema URL 协议读 reference/client-schema.md,API 使用指南读 reference/api-guide.md。