REST API 빠른 시작
BrainTube REST API 시작하기: 인증, 엔드포인트, 첫 호출까지 안내해요.
REST API로 BrainTube 코퍼스에 프로그래밍 방식으로 접근해 보세요.
인증
설정 → API 키에서 API 키를 생성하세요. 요청에 다음과 같이 포함하세요.
Authorization: Bearer bt_sk_your_api_key_here
예시: 코퍼스 검색
검색어와 인증 헤더를 담아 brain-api 엔드포인트로 POST 요청을 보내세요.
사용할 수 있는 엔드포인트
| 엔드포인트 | 메서드 | 설명 |
|---|---|---|
| /brain-api | POST | 메인 API — 검색, 목록 조회, 관리 |
| /brain-chat | POST | 특정 Brain과 채팅 |
| /graph-enhanced-search | POST | 고급 의미 검색 + 그래프 검색 |
응답 형식
모든 응답은 success, data, meta 필드가 담긴 JSON으로 반환돼요.
오류 처리
| 상태 | 의미 |
|---|---|
| 200 | 성공 |
| 401 | API 키가 잘못되었거나 없음 |
| 403 | 권한 부족 |
| 429 | 요청 한도 초과 |
| 500 | 서버 오류 |
도움이 더 필요한가요? 지원팀에 이메일 보내기