用途:本技能面向需要理解紫鸟ERP REST API 能力与边界的场景,例如 ERP 系统对接规划、集成设计、接口评估,或查询接口权限点以便申请开通。它不做具体接口参数的速查,参数细节需按路由表读取 reference/ 下对应文件。
主要能力:API 通过“简单通用模式”(Bearer API Key)认证,覆盖账号、设备、访问策略、角色权限、部门员工五大模块共 72 个接口。账号管理 22 个(CRUD、授权、标签、缓存清除);设备管理 11 个(套餐/设备购买续费、绑定解绑、自有设备);访问策略 22 个(网页/分组、访问规则、账号策略绑定);角色和权限 7 个;部门员工 10 个。边界上不包含 OAuth 授权、浏览器指纹与窗口管理、账单/支付明细、企业创建注销。
使用方式:在开放平台创建“卖家自研应用”并选择简单通用模式获取 API Key,申请对应权限点,配置 IP 白名单。请求头为 Authorization: Bearer {API_Key},Base URL 为 https://sbappstoreapi.ziniao.com/openapi-router,几乎均为 POST + JSON,编码 UTF-8。响应为双层结构:网关层 code="0" 后进入业务层,业务 ret=0 表示成功。核心 ID 包括 companyId、storeId、userId/staffId、proxyId、tagId/tid、roleId、ruleId,其中 companyId 几乎必传。
限制与注意:每个接口归属一个权限点,需申请后才能调用;业务数据位置因接口而异,多数在 data.data,部分直接在业务层根级(如员工新增 v2 返回的 id、password),须以 reference 文件标注为准。资料未提供具体价格、计费方式及除上述模块外的功能。