请求头
| 请求头 | 值 |
|---|---|
Content-Type | application/json |
请求体
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
email | string | 是 | 人工赞助方的邮箱地址。必须是有效的邮箱地址。 |
agent_name | string | 是 | 创建密钥的代理名称 (1–100 个字符) 。会显示在验证邮件中。 |
accept_terms | boolean | 是 | 必须为 true。表示已确认服务条款。 |
响应
| 字段 | 类型 | 描述 |
|---|---|---|
success | boolean | 该密钥是否创建成功 |
api_key | string | 已分配的 API 密钥 (以 fc- 开头) |
sponsor_status | string | 创建时始终为 "pending" |
credit_limit | number | 完成验证前可用的最大额度 (50) |
credits_remaining | number | 剩余额度 (创建时为 50) |
verification_deadline_at | string | ISO 8601 时间戳。赞助方必须在此截止时间前确认 (5 天) 。 |
tos_url | string | 已接受的服务条款 URL |
请求示例
curl -X POST "https://api.firecrawl.dev/v2/agent-signup" \
-H "Content-Type: application/json" \
-d '{
"email": "user@company.com",
"agent_name": "Research Assistant",
"accept_terms": true
}'
示例响应
{
"success": true,
"api_key": "fc-abc123...",
"sponsor_status": "pending",
"credit_limit": 50,
"credits_remaining": 50,
"verification_deadline_at": "2026-03-23T12:00:00.000Z",
"tos_url": "https://firecrawl.dev/terms-of-service"
}
错误响应
| 状态 | 错误 | 何时 |
|---|---|---|
400 | 无效的请求体 | 缺少字段或字段无效 |
403 | 此 email 已禁止代理注册 | 赞助方此前已禁止代理注册 |
403 | 之前的代理注册验证已过期 | 之前的注册已过期；赞助方应登录 |
409 | 已向该 email 发送过一封待处理的代理注册确认 | 此 email 已有一个密钥处于待处理状态 |