接口接入说明

如果你想把 Avelok 和已有系统连接在一起,请先看这里。现在还不能自助申请接口或 API key。

Avelok 现在还不能让外部系统自助接入。

网页里用到的接口,只服务 Avelok 自己的页面。它们可能会随着页面调整,不能直接拿来做正式集成。

如果你想把 Avelok 和赛事系统、俱乐部系统、训练设备或现有会员工具连接起来,请先从具体需求沟通开始。

现在还不能做什么

  • 不能自助申请 API key
  • 不能直接把网页接口用于正式系统
  • 不能批量导出你没有权限查看的数据
  • 不能读取教练没有公开的备注
  • 不能自动发布未经确认的 AI 草稿

为什么需要先沟通

Avelok 里的信息关系比较细。家长能看的训练动态,和教练自己的课程备注分开处理。俱乐部能看到活动和成员状态,但不一定能看到每个学员的全部个人记录。

所以接入前需要说清楚:

  • 你想解决什么问题
  • 哪些用户授权你读取数据
  • 你需要看摘要、状态,还是原始内容
  • 数据是否需要写回 Avelok
  • 用户以后如何取消授权
  • 出错后谁来处理

以后可能先支持哪些接入

这些方向更容易先讨论:

  • 活动报名和签到状态
  • 课程和课包摘要
  • 俱乐部成员或教练摘要
  • 已发送的训练动态摘要
  • 由用户确认后的记录写回

具体是否能接入,要看账号权限、用户授权和数据范围。

请先不要直接调用网页接口

如果你需要系统接入,请先联系 Avelok 确认方案。直接使用网页请求,后续很容易因为页面调整而失效。