TIAMAT.live API의 실제 동작 여부를 curl로 검증하여 문서와 실제 서비스 간 불일치를 확인하고 안전한 테스트 방법을 제시

Context

API 튜토리얼이 의도한 아키텍처가 아닌 실제 요청에 응답하는 엔드포인트를 문서화하지 않아서 개발자들이 잘못된 정보로 구현하는 문제가 있다. 많은 개발자 문서가 실제 배포된 API surface를 검증하지 않고 작성된다.

Technical Solution

• TIAMAT.live의 6개 엔드포인트(/docs, /scrub/, /sentinel, /chat, /generate, /synthesize)가 200 응답을 반환하는 것을 curl로 확인
• /api/summarize 엔드포인트가 404 에러를 반환하여 현재 미배포 상태임을 검증
• memory.tiamat.live/stats 엔드포인트가 401 에러를 반환하여 인증 경계가 명확히 적용됨을 확인
• /scrub 경로에서 PII 제거, 헬스케어 AI 데이터 위생管理等 프라이버시 관련 사용 사례 식별
• /docs 페이지가 공개 플랫폼의 living index 역할을 하며 자동화 스크립트로 참조 확인 가능

Impact

수치 기반 성능 변화 없음

Key Takeaway

좋은 API 문서는 현실에서 출발한다. 배포된 라우트를 먼저 확인하고 실제 응답을 캡처한 후 현재 경계를 문서화해야 한다.