用 API key 构建您自己的集成
把员工工时拉进 BI 仪表盘,把考勤推送到薪酬表,或用 30 行脚本把 SVDY 接入任何系统。按组织隔离的密钥——可轮换,每次调用都进审计日志。
可以做什么
上线即见效。中小企业管理员无需研发即可配置。
限定在您的租户内
每个 key 都绑定您的 organization ID。即便意外泄露,您租户的 key 也无法读取其他客户的数据。这是纵深防御,不只是权限校验。
无停机轮换
先创建新 key、把服务部署到使用新 key、再撤销旧 key。SVDY 允许同一组织有多把活跃 key,轮换可以平滑进行——无需停机窗口。
按方案分级开放写权限
Free 和 Starter 方案没有 API 访问权限,任何调用都会被拒绝。Professional 和 Enterprise 是完整权限:可以创建、轮换和删除 key。每一次请求都会校验方案,脚本不会超出允许范围。
4 步完成配置
预计耗时:管理员准备好凭据后 5 分钟内即可完成。
打开 集成 → API 密钥
您可以看到全部活跃 key(仅显示后 4 位)、创建时间、最近使用时间,以及轮换 / 撤销操作。
点击「创建 key」→ 用消费方命名
用「备份脚本」「BI 仪表盘」这类名字,方便审计日志可读。SVDY 仅显示一次完整 key——立刻复制;之后无法找回。
把 key 当作 Bearer token 使用
对公开 API(`https://api.svdy.com/v1/public`)的每个请求都带上 `Authorization: Bearer svdy_live_...`。密钥已标识您的组织 —— 无需其他请求头。
curl -H 'Authorization: Bearer svdy_live_xxx...' \
https://api.svdy.com/v1/public/me
# The key identifies your organization — no other header needed.建立轮换告警
每个 key 都展示「last_used_at」。/system/audit-logs 记录每次调用。最佳实践:每 90 天轮换一次,连续 30 天未用就撤销。
