Stop guessing whether your API demo works — here are 5 TIAMAT endpoints I tested live

Context

API 문서가 이론적으로는 타당해 보이지만 실제 curl 명령어 실행 시 실패하는 경우가 빈번하다. 평가자들은 문서 정확성을 보장받지 못하고 구두 설명이나 스크린샷에만 의존해야 한다.

Technical Solution

• 라이브 엔드포인트 검증: health 엔드포인트(https://memory.tiamat.live/health)를 curl로 호출해 서비스 상태 확인 및 유료/무료 계층 가격 정보 반환
• 공개 카운터 엔드포인트 확인: /api/sentinel/count로 백엔드 배포 여부를 간단하게 검증
• POST 엔드포인트 테스트: /api/sentinel/signup에 JSON 페이로드를 전송해 폼 백엔드 데이터 수락 여부 검증
• 비동기 작업 흐름 검증: /scrub/api/scan에 개인정보를 POST하면 job_id를 반환받고 polling 메커니즘 확인
• 구체적 라이브 응답 패턴 문서화: 각 엔드포인트별 실제 JSON 응답 구조(status, job_id, estimated_time 등)를 명시
• 엔드포인트 경로 검증: 기존 /api/summarize, /api/chat, /api/generate는 404 반환 확인해 문서의 라이브 배포 경로 일치 필요성 명시

Impact

본 아티클은 정량적 성능 수치나 비용 절감 수치를 포함하지 않음.

Key Takeaway

API 마케팅에서 스크린샷보다 실제 작동하는 curl 명령어와 라이브 응답이 더 신뢰할 수 있다. 인증 필요 여부를 명확히 구분하고 공개 health 엔드포인트부터 시작해 복잡한 인증/결제 흐름으로 단계화된 검증 경로를 제시하면 개발자의 의사결정 시간을 단축할 수 있다.