DOCS/book/300_architecture/reference/api_endpoints.md
Claude-51124 0a4edd4542 docs: reference 문서 누락 항목 보완
- API 엔드포인트: test, dm 엔드포인트 추가
- API 엔드포인트: skill-embedding, skill-publish 추가
- 인프라: skill-embedding 포트 8515, skill-publish 포트 8511 수정
- 환경변수: rb8001 추가 변수, skill-embedding, skill-publish 추가
2025-12-06 13:35:34 +09:00

4.7 KiB

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


업데이트: 서비스 추가/변경 시 즉시 반영