合作伙伴集成 API

Firecrawl 合作伙伴集成 API 允许已获批准的合作伙伴直接在自己的平台内为其用户创建和管理 Firecrawl API 密钥。这让用户无需离开合作伙伴的平台，即可无缝完成接入并开始使用 Firecrawl。

有关合作伙伴用户可获得内容的详细信息，包括额度、有效期和套餐限制，请参见 Partner Credits。

https://integrations.firecrawl.dev

所有 合作伙伴集成 API 请求都必须在 Authorization 标头中附带您的合作伙伴密钥：

Authorization: Bearer <partner key>

合作伙伴密钥与标准 Firecrawl API 密钥不同，由 Firecrawl 团队直接提供。

• 仅限服务器端：合作伙伴密钥只能用于服务器端代码。切勿在前端代码、客户端 JavaScript 或移动应用中暴露合作伙伴密钥。
• 服务条款：调用 POST /partner/v1/accounts 前，你的平台必须提示用户接受 Firecrawl 的 服务条款。

创建与用户邮箱地址关联的 Firecrawl API 密钥。

POST /partner/v1/accounts

• 如果用户尚未拥有 Firecrawl 账户，则会创建一个新用户和新团队。
• 如果用户已拥有 Firecrawl 账户，但还没有与你的合作伙伴集成关联的团队，则会创建一个新的合作伙伴关联团队。
• 如果用户已拥有 Firecrawl 账户，并且已经有与你的合作伙伴集成关联的团队，则会返回现有团队，且不会再次应用促销优惠券。

curl -X POST "https://integrations.firecrawl.dev/partner/v1/accounts" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

请求体

200 OK

{
  "apiKey": "fc-...",
  "alreadyExisted": false
}

验证 Firecrawl API 密钥，并返回关联的团队名称和用户邮箱地址。只有通过此合作伙伴集成创建的 API 密钥才会被视为有效。

POST /partner/v1/api-keys/validate

• Firecrawl API 密钥不设权限，也不会过期。
• 用户可以随时手动删除 API 密钥。
• 已删除的 API 密钥不会进行软删除。Firecrawl 无法区分某个密钥是已被删除，还是从未存在过。

curl -X POST "https://integrations.firecrawl.dev/partner/v1/api-keys/validate" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "fc-..."}'

请求体

200 OK

{
  "teamName": "Example Team",
  "email": "[email protected]"
}

删除现有的 Firecrawl API 密钥，并为同一用户和团队生成一个新的密钥。

POST /partner/v1/api-keys/rotate

curl -X POST "https://integrations.firecrawl.dev/partner/v1/api-keys/rotate" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "fc-..."}'

请求体

200 OK

{
  "apiKey": "fc-..."
}

Firecrawl 的合作伙伴计划仅向获批平台开放。如果你有意将 Firecrawl 集成到自己的平台中，并向用户提供额度，请通过 [email protected] 联系我们，了解更多信息并申请合作伙伴 API 密钥。