能力开放平台术语（OPEN API）

能力开放平台（Open API Platform）

定义：能力开放平台是云智易将平台核心能力以统一、标准化 API 接口形式对外开放的能力体系，用于支持第三方系统、企业应用及合作伙伴安全、规范地访问平台资源。
作用：支撑系统集成、能力复用、生态合作与扩展开发，是平台对外连接与能力输出的统一入口。
归属平台：全平台（X-Link / X-Cube / X-AI / X-Edge）

Open API（开放接口）

定义：Open API 是能力开放平台对外提供的标准接口，用于访问设备数据、事件信息、业务对象或执行控制指令。
作用：实现平台能力的标准化输出，避免点对点集成和定制开发。
归属平台：能力开放平台

API 网关（API Gateway）

定义：API 网关是统一管理接口访问、认证、路由、限流与审计的基础设施组件。
作用：保障接口调用的安全性、稳定性和可控性，是企业级 API 管理的核心组件。
归属平台：能力开放平台

服务包（Service Package）

定义：服务包是对外开放 API 的逻辑分组方式，按能力或应用场景对接口进行统一组织和管理。
作用：帮助用户快速理解和使用一组相关能力，提升接口查找与管理效率。
归属平台：能力开放平台

接口能力封装（Capability Encapsulation）

定义：将平台内部的设备模型、数据结构和业务逻辑，通过标准 API 形式对外封装的过程。
作用：隐藏平台内部复杂性，对外提供稳定、可复用的能力接口。
归属平台：能力开放平台

接口调用规范（API Specification）

定义：对 API 的请求方式、参数结构、返回格式、错误码等进行统一约定的规范说明。
作用：保证不同系统在集成过程中对接口理解一致，降低对接成本。
归属平台：能力开放平台

接口认证与授权（API Authentication & Authorization）

定义：通过应用标识、密钥或令牌等方式，对接口访问方进行身份校验与权限控制的机制。
作用：确保接口能力在开放使用过程中的安全性与可控性。
归属平台：能力开放平台

接口权限控制（API Permission Control）

定义：对不同应用或系统可访问的 API 范围、数据范围与操作权限进行限制的机制。
作用：实现能力按需开放，避免越权访问和数据滥用。
归属平台：能力开放平台

实时数据接口（Real-time Data API）

定义：用于获取设备或业务对象实时状态、最新数据的接口能力。
作用：支撑实时监控、联动控制与即时决策场景。
归属平台：能力开放平台 / X-Link

事件订阅接口（Event Subscription API）

定义：支持外部系统订阅设备事件、告警或状态变化的接口机制。
作用：用于跨系统联动、自动化流程触发与异步通知。
归属平台：能力开放平台 / X-Link / X-Edge

控制指令接口（Command API）

定义：用于向设备或边缘节点下发控制指令的接口能力。
作用：实现平台能力向现场系统的反向输出与联动控制。
归属平台：能力开放平台 / X-Link / X-Edge

接口调用日志（API Call Log）

定义：对接口调用过程进行记录的日志数据，包括调用时间、请求方、结果状态等信息。
作用：用于问题排查、运行监控与审计分析。
归属平台：能力开放平台

接口限流与配额（Rate Limiting & Quota）

定义：对接口调用频率、并发数或总调用量进行限制的机制。
作用：防止接口被滥用，保障平台整体稳定性。
归属平台：能力开放平台

接口版本管理（API Versioning）

定义：对 API 的版本进行标识和管理的机制，用于支持能力演进与兼容性控制。
作用：确保接口在升级过程中不影响已有系统的正常使用。
归属平台：能力开放平台

能力复用（Capability Reuse）

定义：将已开放的 API 能力在多个系统、应用或场景中重复使用的方式。
作用：降低重复开发成本，提升平台能力的规模化价值。
归属平台：能力开放平台 / X-Cube

跨系统集成（System Integration）

定义：通过 Open API 将云智易平台能力与外部系统进行数据与业务层面的对接。
作用：实现业务协同与数据共享，打通系统边界。
归属平台：能力开放平台