141 lines
4.7 KiB
Markdown
141 lines
4.7 KiB
Markdown
# API 엔드포인트 참조
|
|
|
|
**작성일**: 2025-12-06
|
|
**목적**: 개발 시 API 엔드포인트 중복/오류 방지, 빠른 참조
|
|
|
|
---
|
|
|
|
## rb8001 (메인 서비스, 8001)
|
|
|
|
### 메시지 처리
|
|
| 엔드포인트 | 메서드 | 설명 | 인증 |
|
|
|-----------|--------|------|------|
|
|
| `/api/message` | POST | Gateway/Frontend 메시지 처리 | JWT 필수 |
|
|
| `/api/feedback/chat` | POST | 채팅 피드백 (좋아요/싫어요) | JWT 필수 |
|
|
|
|
**참고**: `rb8001/app/router/message_endpoint.py:26`, `rb8001/main.py:85`
|
|
|
|
### LLM
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/api/llm/generate` | POST | 텍스트 생성 |
|
|
| `/api/llm/summarize` | POST | 요약 |
|
|
| `/api/llm/complete` | POST | 완성 |
|
|
| `/api/llm/health` | GET | 헬스체크 |
|
|
|
|
**참고**: `rb8001/app/router/llm_endpoint.py:28,55,93,124`
|
|
|
|
### 감정 분석
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/api/emotion/infer` | POST | 감정 추론 |
|
|
| `/api/emotion/timeseries` | GET | 시계열 데이터 |
|
|
| `/api/emotion/team-insight` | GET | 팀 인사이트 |
|
|
| `/api/emotion/process-message` | POST | 메시지 처리 |
|
|
| `/api/emotion/health` | GET | 헬스체크 |
|
|
|
|
**참고**: `rb8001/app/router/emotion_endpoint.py:75,150,188,263,303`
|
|
|
|
### 기억 온톨로지
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/api/v1/memory/event` | POST | 사건 저장 |
|
|
| `/api/v1/memory/recall` | POST | 회상 |
|
|
| `/api/v1/memory/stats` | GET | 통계 |
|
|
|
|
**참고**: `rb8001/app/router/memory_ontology.py:69,118,181`
|
|
|
|
### Intent 리뷰
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/api/intent-review/queue` | GET | 큐 조회 |
|
|
| `/api/intent-review/{item_id}/label` | PUT | 라벨 업데이트 |
|
|
| `/api/intent-review/stats` | GET | 통계 |
|
|
|
|
**참고**: `rb8001/app/router/intent_review_endpoint.py:33,58,81`
|
|
|
|
### IR Deck 평가
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/api/ir-deck/upload` | POST | PDF 업로드 |
|
|
| `/api/ir-deck/evaluate` | POST | 평가 시작 |
|
|
| `/api/ir-deck/evaluation/{evaluation_id}` | GET | 평가 결과 |
|
|
| `/api/ir-deck/chat` | POST | 채팅 |
|
|
| `/api/ir-deck/feedback` | POST | 피드백 |
|
|
|
|
**참고**: `rb8001/app/router/ir_deck.py:109,169,263,297,344`
|
|
|
|
### Slack
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/slack/events` | POST | Slack 이벤트 |
|
|
| `/slack/slash` | POST | 슬래시 명령어 |
|
|
| `/slack/health` | GET | 헬스체크 |
|
|
|
|
**참고**: `rb8001/app/router/slack_endpoint.py:33,70,117`
|
|
|
|
### DM (Direct Message)
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/dm/send` | POST | 모든 사용자 DM 전송 |
|
|
| `/dm/send-to-user` | POST | 특정 사용자 DM 전송 |
|
|
| `/dm/health` | GET | 헬스체크 |
|
|
|
|
**참고**: `rb8001/app/router/dm_endpoint.py:10,35,58`
|
|
|
|
### Test (개발용)
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/api/test/router-message` | POST | Router 플로우 테스트 |
|
|
| `/api/test/message` | POST | 메시지 처리 테스트 |
|
|
| `/api/test/memory/store` | POST | 메모리 저장 테스트 |
|
|
| `/api/test/memory/search` | POST | 메모리 검색 테스트 |
|
|
| `/api/test/memory/stats` | GET | 메모리 통계 |
|
|
| `/api/test/emotion` | POST | 감정 분석 테스트 |
|
|
| `/api/test/health` | GET | 헬스체크 |
|
|
|
|
**참고**: `rb8001/app/router/test_endpoint.py:29,74,110,137,165,175,200`
|
|
|
|
---
|
|
|
|
## skill-* 서비스
|
|
|
|
| 서비스 | 포트 | 주요 엔드포인트 | 참고 |
|
|
|--------|------|----------------|------|
|
|
| skill-email | 8501 | `/health` | - |
|
|
| skill-news | 8505 | `/health` | `skill_news/README.md:30` |
|
|
| skill-slack | 8502 | `/health` | `skill-slack/README.md:23` |
|
|
| skill-rag-file | 8508 | `/healthz`, `/api/upload`, `/api/search` | `skill-rag-file/app/main.py:60` |
|
|
| skill-calendar | 8512 | `/health`, `/api/events` | `skill-calendar/README.md:23` |
|
|
| skill-embedding | 8515 | `/health`, `/api/embed` | `skill-embedding/docker-compose.yml:14` |
|
|
| skill-publish | 8511 | `/health` | `skill-publish/docker-compose.yml:9` |
|
|
|
|
---
|
|
|
|
## robeing-monitor (9024)
|
|
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/health` | GET | 헬스체크 |
|
|
| `/api/stats/{robeing_id}` | GET/PUT | 스탯 조회/업데이트 |
|
|
| `/api/monitor/robeings` | GET | 로빙 상태 |
|
|
| `/api/monitor/skills` | GET | 스킬 서비스 상태 |
|
|
|
|
**참고**: `robeing-monitor/README.md:68`, `robeing-monitor/app/api/monitor.py`
|
|
|
|
---
|
|
|
|
## Gateway (8100)
|
|
|
|
| 엔드포인트 | 메서드 | 설명 |
|
|
|-----------|--------|------|
|
|
| `/gateway/slack/events` | POST | Slack 이벤트 프록시 |
|
|
| `/gateway/*` | * | 각 서비스 프록시 |
|
|
|
|
**참고**: `AGENTS.md:88-92`
|
|
|
|
---
|
|
|
|
**업데이트**: 서비스 추가/변경 시 즉시 반영
|
|
|