API 接口 · 快速开始

欢迎使用 ATECLOUD 开放接口。通过本 API，你可以实现方案获取、运行测试、数据推送等能力，将 ATECLOUD 集成到你的业务系统中。

阅读对象

贵公司技术部门的开发、维护及管理人员，应具备以下基本知识：

1. 了解 HTTPS/HTTP 协议等内容
2. 了解信息安全的基本概念
3. 了解计算机至少一种编程语言

使用条款

1. ATECLOUD 用户是资源的拥有者，需尊重和保护用户的权益
2. 未经用户允许，不准爬取或存储用户的资源
3. 禁止滥用 API，请求频率过快将导致请求终止

三步接入

① 准备            ② 创建应用            ③ 调用接口
申请平台账号       外部应用→应用维护      鉴权拿 token
获取 DEMO 包   →   勾选权限、设间隔   →   按接口文档调用
确认访问地址       生成 key/secret       订阅数据推送

第一步：准备

• 申请平台账号等信息
• 取得开发文档、调试接口 DEMO 包等资料（可联系服务人员获取）
• 确认访问地址：
  • 企业版：[服务器IP]:8001
  • 单工位版：[一体机IP]:8001

第二步：创建应用

1. 登录平台，进入【外部应用】→【应用维护】，点击新增应用

2. 填写应用信息，勾选应用所需的权限，设置访问间隔时间

3. 创建成功后生成 key 和 secret，认证流程会用到

第三步：鉴权并调用

• 用 key + secret 调用鉴权接口换取 token
• 携带 token 调用业务接口（获取方案、创建测试实例等）
• 需要实时数据时，用订阅接口配置 callback_url，由平台主动推送

典型集成场景

场景	使用接口	说明
拉取测试数据做二次分析	获取记录 / 获取数据 + 定时轮询	适合对实时性要求不高的场景
MES 联动自动测试	获取方案 → 创建实例 → 下发状态	由上游系统触发测试并控制流程
实时大屏 / 质量监控	订阅接口 + 推送回调	平台主动推送，实时性最好

下一步

• 认证鉴权 —— 理解 token 机制与三类流程图
• API 参考 —— 逐个接口的参数与示例
• 数据订阅 —— 回调报文字段说明
• 接入测试 —— DEMO 导入与常见问题