API 使用条款

最后更新 : 18/10/2026

这些条款（「API 条款」）管辖对 YA-Planning 开发者 API（「API」）的访问和使用。它们是对本服务《使用条款》的补充。通过创建 API 密钥或调用 API，您（「开发者」）即接受这些条款。

1. 访问与 API 密钥

注册后即可免费访问。每个密钥都与一个机构以及一组由您按最低必要选择的 scope（权限）相关联。密钥的机密部分仅显示一次：请妥善保管。您对使用您的密钥进行的所有活动负责。请立即报告任何泄露并吊销相关密钥。

2. 环境

yap_test_ 密钥（沙盒）作用于演示数据，不影响任何真实数据；其写入功能已禁用。yap_live_ 密钥作用于您的生产数据。请先在沙盒中测试，再切换到生产环境。

3. 可接受使用

• 请勿超过速率限制；在出现 429 时采用带退避的重试机制。
• 仅将 API 用于您获得授权的机构。
• 不得进行逆向工程、绕过访问控制或未经授权的渗透测试。
• 不得进行损害服务可用性、完整性或安全性的使用。
• 切勿在公共客户端暴露您的密钥（代码仓库、无代理的前端应用）。

4. 数据保护

通过 API 可访问的数据（学生、教师、课程表）是属于机构的个人数据。您以机构受托处理者的身份行事，并承诺仅为与其约定的目的处理这些数据、对其进行保护、不予转售，并遵守 GDPR 及适用法规。接收 webhook 时必须验证 HMAC 签名和时间戳的新鲜度。

5. 可用性、版本与弃用

API 按「现状」提供，对免费方案不提供服务级别保证。我们可随时以向后兼容的方式演进 API。任何破坏性变更均通过新的主版本以及至少 90 天的提前通知发布（Deprecation 标头和文档变更日志）。

6. 暂停

在违反这些条款、滥用、存在安全风险或法律义务的情况下，我们可在有或没有提前通知的情况下暂停或吊销密钥。

7. 责任

在法律允许的范围内，YA-Planning 对与使用 API 相关的间接损害不承担责任。对于因您使用 API 或不遵守这些条款而引起的索赔，您应保障 YA-Planning 免受损害。

8. 联系方式

有关 API 的问题： api@yaplanning.com.

非合同性文件 — 临时版本，投入生产前需经法律审核。