API keys

​

创建 key

1. 到 hermai.ai/dashboard 登录
2. 进入 API Keys
3. 点 Create key,给它一个标签
4. 复制 key - 只会显示一次,之后无法找回

​

使用 key

curl -sS -X POST "https://api.hermai.ai/v1/fetch" \
     -H "Authorization: Bearer hm_sk_abc123..." \
     -H "Content-Type: application/json" \
     -d '{"site":"semanticscholar.org","endpoint":"get_paper","params":{"paper_id":"ARXIV:1706.03762","fields":"title,authors,year"}}'

​

key 能做什么

​

Schema 访问开关

• 仅认证 - catalog 只返回经 Hermai 团队审核认证的 schema。最安全选项。
• 全部 schema(默认) - 同时包含认证与未认证的社区贡献。覆盖更广,审核更少。

​

撤销 key

​

安全

• Key 用于验证请求,不用于请求签名 - 只是 Bearer token 验证。
• 安全保管 key,不要提交到版本控制。
• 每个 key 可独立撤销,可在不影响其他 key 的情况下轮换。
• Key 在服务端以 hash 存储 - 丢失无法恢复。