API 요청 한도와 권장 사항

BrainTube API 연동이 원활하게 돌아가도록 관리해 보세요.

요청 한도

한도에 도달하면 Retry-After 헤더와 함께 429 응답을 받아요.

권장 사항

1. 결과 캐시하기 — 바뀌지 않은 데이터를 다시 가져오지 마세요. 최소 5분 동안 캐시하세요.
2. 알맞은 엔드포인트 사용하기 — 빠른 조회에는 search를, 깊이 있는 결과에는 graph-enhanced-search를 사용하세요.
3. 요청 묶기 — limit 값을 높여 한 번의 쿼리로 여러 항목을 가져오세요.
4. 오류를 부드럽게 처리하기 — 429 응답에 대해 백오프를 적용한 재시도 로직을 구현하세요.
5. 웹훅 사용하기 — 폴링 대신 Supabase Realtime을 고려해 보세요.

사용량 모니터링

API 사용량은 설정에서 확인할 수 있어요. 키마다 last_used 타임스탬프와 total_requests 횟수가 표시돼요.

더 높은 한도가 필요하신가요?

대량 요청이 필요한 연동이라면 고객지원에 문의해 맞춤 요청 한도를 받으세요.