（3786期）ziniao-erp-api-doc – 紫鸟ERP API 架构与集成指南

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