跳到主要内容
开发者指南
已上线
Professional 方案

用 API key 构建您自己的集成

把员工工时拉进 BI 仪表盘,把考勤推送到薪酬表,或用 30 行脚本把 SVDY 接入任何系统。按组织隔离的密钥——可轮换,每次调用都进审计日志。

可以做什么

上线即见效。中小企业管理员无需研发即可配置。

限定在您的租户内

每个 key 都绑定您的 organization ID。即便意外泄露,您租户的 key 也无法读取其他客户的数据。这是纵深防御,不只是权限校验。

无停机轮换

先创建新 key、把服务部署到使用新 key、再撤销旧 key。SVDY 允许同一组织有多把活跃 key,轮换可以平滑进行——无需停机窗口。

按方案分级开放写权限

Free 和 Starter 方案没有 API 访问权限,任何调用都会被拒绝。Professional 和 Enterprise 是完整权限:可以创建、轮换和删除 key。每一次请求都会校验方案,脚本不会超出允许范围。

4 步完成配置

预计耗时:管理员准备好凭据后 5 分钟内即可完成。

1

打开 集成 → API 密钥

您可以看到全部活跃 key(仅显示后 4 位)、创建时间、最近使用时间,以及轮换 / 撤销操作。

2

点击「创建 key」→ 用消费方命名

用「备份脚本」「BI 仪表盘」这类名字,方便审计日志可读。SVDY 仅显示一次完整 key——立刻复制;之后无法找回。

3

把 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.
4

建立轮换告警

每个 key 都展示「last_used_at」。/system/audit-logs 记录每次调用。最佳实践:每 90 天轮换一次,连续 30 天未用就撤销。


准备好接入了吗?

打开您所在组织的管理后台 → 集成,5 分钟内即可完成接入。