API BODACC : 인증 및 한도
무료 공개 액세스
BODACC API는 모든 데이터 엔드포인트(공고, 기업, 개인, 디렉토리, 통계)에서 키 없이 개방되어 있습니다. 공개 데이터를 즉시 조회할 수 있습니다:
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"
API 키 받기
Pro 및 Enterprise 요금제는 내 계정 → API (/{locale}/mon-compte/api)에서 API 키(접두사 sk_bodacc_)를 제공합니다. 이 키는 해당 키를 요구하는 문서화된 엔드포인트에 대한 액세스를 해제합니다.
키 전달 방법
두 가지 허용되는 헤더가 있습니다:
# 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_..."
유효하지 않거나 해지된 키는 명확한 JSON 본문과 함께 401을 반환합니다. 키가 없으면 공개 액세스가 유지됩니다(오류 없음).
오류 코드
| 코드 | 의미 |
|---|---|
400 | 잘못된 매개변수(예: 알 수 없는 디렉토리 역할) |
401 | API 키가 유효하지 않거나 해지됨 |
404 | 리소스를 찾을 수 없음(공고, SIREN, 개인) |
429 | 요청이 너무 많거나 할당량 초과 — Retry-After 준수 |
한도 및 모범 사례
- Rate limit : 키 없이 IP당 분당 60회 요청, 유효한 키 사용 시 600회
- 일일 할당량 : 키 없이 IP당 하루 10,000회 요청, 키 사용 시 100,000회 — 필터의 체계적 반복(데이터베이스 전체 덤프)을 차단하며, 카운터는 매일 재설정됩니다
- 덤프 방지 경계 : 공고/기업/사무소에서
limit≤ 500,offset≤ 10,000, 디렉토리 및 행위자는 100개씩 200페이지로 제한 - 체계적 페이지네이션 : 대량 요청 대신
offset(또는 디렉토리의 경우page/per_page)을 반복 Retry-After:429발생 시 재시도 전에 표시된 시간을 기다리세요- 총계 : 대시보드에는
COUNT(*)대신 (구체화된)stats/counts및stats/daily를 선호하세요 - 실시간 데이터 : BODACC가 게재될 때마다 데이터가 새로 고쳐집니다
- 캐시 : 일반적인 검색은 Cloudflare 엣지 캐시(300초)를 통해 제공되며, 반복 요청은 할당량에 포함되지 않습니다