> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dropcv.work/llms.txt
> Use this file to discover all available pages before exploring further.

# 鉴权

> API Key 的生成、使用、撤销，以及 write 权限说明。

DropCV Skills API 使用 **Bearer Token (API Key)** 鉴权。

## 生成 API Key

1. 登录 [DropCV](https://app.dropcv.work)
2. 进入 **设置 → API Keys**
3. 点击"新建 Key"，起一个识别名字（例如"我的 Claude Desktop"）
4. 点击"生成"，弹窗会显示完整的 key

<Warning>
  Key 明文只显示一次。关闭弹窗后无法再次查看。请立即复制到安全位置。
</Warning>

Key 格式：`drop_cv_<32 位随机字符>`，共 40 字符。

## 使用 API Key

所有调用都要在 HTTP 头中带 `Authorization: Bearer <key>`：

```bash theme={null}
curl ... -H "Authorization: Bearer drop_cv_..."
```

## 默认 read-only

新建的 Key **默认只能调读 skill**（candidate\_search / candidate\_profile\_read / jd\_parse）。

调用写 skill（save\_candidate / candidate\_update / 文件上传）需要先在 API Keys 页面勾选"允许写入"开关。

这是为了避免你不小心把 key 贴到陌生工具时被写脏数据。

## 撤销 Key

API Keys 页面点击撤销按钮即可。撤销后**60 秒内**所有 DropCV 实例同步生效。

## 多个 Key

强烈建议为每个 AI 工具单独建一个 key（例如"Claude Desktop"、"Cursor"、"我的脚本"）。

如果某个 key 泄露了，单独撤销那个 key，不影响其他工具的接入。

## 查看 Key 的调用记录

[DropCV 设置 → 用量](https://app.dropcv.work/dashboard/settings/usage) 里可以看到：

* 过去 30 天的总调用数、错误率、p95 延迟
* 按 skill 分布的调用次数
* 每条调用记录（时间、skill、key、状态、延迟、客户端）
* 点击某条记录查看完整请求参数（用于排查问题）

调用日志的留存按 hr-ai 部署的数据保留策略来。