BODACC API 密钥 : 认证与限制
免费公开访问
BODACC API 在所有数据端点上无需密钥即可开放访问：公告、企业、人员、名录、统计。您可以立即查询公开数据：
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"
获取 API 密钥
Pro 和 Enterprise 套餐提供 API 密钥（前缀 sk_bodacc_），可从您的 我的账户 → API 页面（/{locale}/mon-compte/api）获取。该密钥可解锁文档中要求密钥的端点访问权限。
传递密钥
支持两种请求头：
# X-API-Key 请求头
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
-H "X-API-Key: sk_bodacc_..."
# 或 Authorization Bearer
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
-H "Authorization: Bearer sk_bodacc_..."
无效或已撤销的密钥会返回 401 状态码及明确的 JSON 响应体。缺少密钥时公开访问保持开放（不会报错）。
错误代码
| 代码 | 含义 |
|---|---|
400 | 参数无效（例如未知的名录角色） |
401 | API 密钥无效或已撤销 |
404 | 资源未找到（公告、SIREN、人员） |
429 | 请求过多或配额已超限 — 请遵守 Retry-After |
限制与最佳实践
- 速率限制：无密钥时每 IP 每分钟 60 次请求，持有有效密钥时为 600 次
- 每日配额：无密钥时每 IP 每天 10,000 次请求，持有密钥时为 100,000 次 — 该限制会阻止对过滤条件的系统性遍历（完整数据库抓取）；计数器每天重置
- 反抓取边界：公告/企业/事务所的
limit≤ 500，offset≤ 10,000；名录和参与者限制为 200 页，每页 100 条 - 系统化分页：请通过
offset（或名录的page/per_page）进行迭代，而非请求大批量数据 Retry-After：收到429时，请等待响应中指定的时长后再重试- 统计总数：对于仪表盘，请优先使用
stats/counts和stats/daily（物化数据），而非COUNT(*) - 实时数据：数据在每次 BODACC 发布后刷新
- 缓存：常见搜索由 Cloudflare 边缘缓存提供服务（300 秒）— 您的重复请求不计入配额