> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/api/authentication.md).

# Duaer 公开 API 的身份验证

Duaer 用 API 密钥鉴权公开 REST API。
## 创建 API 密钥

1. 登录 Duaer。
2. 打开 Settings → API。
3. 选择 Create an API key。
4. 填写 Label，并设置过期时间。
5. 如套餐支持，选择 Scopes。
6. 复制密钥。完整值只显示一次。

## 用密钥调用 API

把密钥放在请求头 `X-DUAER-API-KEY` 里。不要放进 URL。

例如列出处于活动状态的数字组织：

```
curl -X 'GET' \
  '<DUAER_HOST>/api/v1/workflows?active=true' \
  -H 'accept: application/json' \
  -H 'X-DUAER-API-KEY: <your-api-key>'
```

删除密钥：在 Settings → API 中对该密钥选择 Delete，再确认 Delete Forever。
## Questions

### Duaer API 密钥放在哪个请求头？

放在 `X-DUAER-API-KEY`。完整密钥只在创建时显示一次。