核心用法
ziniao-erp-api-doc 是面向开发者与系统架构师的技术参考 Skill，用于理解紫鸟浏览器 ERP REST API 的整体能力与集成设计。其核心功能包括：
- 全局架构认知：掌握 API Key 认证机制、双层响应结构（网关层+业务层）、核心 ID 体系（companyId/storeId/userId 等）
- 权限体系规划：了解 5 大模块（账号/设备/访问策略/角色权限/部门员工）对应的 18 个权限点申请策略
- 集成设计参考：基于 72 个接口的能力边界，规划 ERP 对接方案与数据流转逻辑
显著优点
1. 企业级覆盖完整：涵盖账号 CRUD、设备全生命周期、访问策略管控、组织架构管理四大核心业务域
2. 权限粒度精细：18 个独立权限点支持按需申请，符合最小权限原则
3. 认证模式简洁：Bearer API Key 模式降低对接复杂度，无需 OAuth 流程
4. 文档结构清晰：Level 0-2 分层设计，快速定位所需信息
潜在局限
- 认证模式单一：仅支持简单通用模式，不支持 OAuth 2.0 等标准授权协议
- 响应结构不统一：业务数据位置因接口而异（
data.data或业务层根级），增加解析复杂度 - 功能边界明确：不包含浏览器指纹配置、窗口管理、账单明细、企业级顶级管理
- IP 白名单约束：需预先配置，灵活性受限
适合人群
- ERP/第三方系统开发者进行紫鸟浏览器集成
- 企业 IT 架构师评估对接可行性
- 运维工程师规划权限申请与接口监控
常规风险
- 权限申请遗漏：未完整申请权限点导致接口调用失败（code≠0）
- 响应解析错误：混淆双层结构，误判业务状态
- ID 体系误用：companyId 等核心参数传递错误影响全链路调用
- 环境配置疏漏：IP 白名单或 Content-Type 设置不当导致认证失败