接口接入说明
如果你想把 Avelok 和已有系统连接在一起,请先看这里。现在还不能自助申请接口或 API key。
Avelok 现在还不能让外部系统自助接入。
网页里用到的接口,只服务 Avelok 自己的页面。它们可能会随着页面调整,不能直接拿来做正式集成。
如果你想把 Avelok 和赛事系统、俱乐部系统、训练设备或现有会员工具连接起来,请先从具体需求沟通开始。
现在还不能做什么
- 不能自助申请 API key
- 不能直接把网页接口用于正式系统
- 不能批量导出你没有权限查看的数据
- 不能读取教练没有公开的备注
- 不能自动发布未经确认的 AI 草稿
为什么需要先沟通
Avelok 里的信息关系比较细。家长能看的训练动态,和教练自己的课程备注分开处理。俱乐部能看到活动和成员状态,但不一定能看到每个学员的全部个人记录。
所以接入前需要说清楚:
- 你想解决什么问题
- 哪些用户授权你读取数据
- 你需要看摘要、状态,还是原始内容
- 数据是否需要写回 Avelok
- 用户以后如何取消授权
- 出错后谁来处理
以后可能先支持哪些接入
这些方向更容易先讨论:
- 活动报名和签到状态
- 课程和课包摘要
- 俱乐部成员或教练摘要
- 已发送的训练动态摘要
- 由用户确认后的记录写回
具体是否能接入,要看账号权限、用户授权和数据范围。
请先不要直接调用网页接口
如果你需要系统接入,请先联系 Avelok 确认方案。直接使用网页请求,后续很容易因为页面调整而失效。