문제 해결

원인

• JSON 형식 오류
• 필수 필드 누락
• 엔드포인트 URL 불일치

해결책

• JSON 형식 검증
• API 문서에서 필수 필드 확인
• 엔드포인트 URL 확인

원인

• Authorization 헤더 누락 또는 비어있음
• API 키 형식 오류 (tm_test_xxx... 또는 tm_live_xxx... 형식이어야 함)
• 해당 엔드포인트에 맞지 않는 API 키
• 엔드포인트 소유자가 API 키를 비활성화함

해결책

• Authorization 헤더 포함 (예: Bearer tm_test_xxx...)
• 샌드박스는 tm_test_xxx..., 프로덕션은 tm_live_xxx... 사용
• 필요시 키 재생성
• 엔드포인트 소유자에게 API 키 재활성화 요청

원인

• 엔드포인트 비활성화 상태
• 구독 만료 또는 월간 한도 초과
• 프로덕션 미배포 (tm_live_ 키 사용 시)

해결책

• 엔드포인트 활성 상태 확인
• 구독 상태 확인
• tm_live_ 키 사용 시 프로덕션에 배포

원인

• Content-Type 헤더 누락 또는 오류
• Content-Type은 application/json이어야 함

해결책

• 헤더 추가: Content-Type: application/json

원인

• 월간 요청 한도 초과

해결책

• 플랜 업그레이드 또는 월간 리셋 대기
• 대시보드에서 사용량 모니터링

500 (Internal Server Error), 502 (Bad Gateway), 503 (Service Unavailable) 등을 포함합니다.

원인

• 일시적인 서버 문제
• 업스트림 서비스(데이터베이스)가 일시적으로 사용 불가
• 서비스가 일시적으로 과부하 또는 점검 중

해결책

• 지수 백오프로 재시도 구현 (예: 1초 → 2초 → 4초, 최대 3회)
• 오류가 지속되면 서비스 상태 확인
• 문제 지속 시 지원팀 연락: contact@3minapi.com
• 참고: 5xx는 요청이 수신되지 않았다는 의미입니다. 202 Accepted를 받으면 데이터 처리가 보장됩니다.

• 웹훅 URL이 올바른지 확인
• HTTP 또는 HTTPS URL 사용
• 엔드포인트가 공개적으로 접근 가능해야 함
• 로그에서 웹훅 상태 확인

• 성공 시 2xx 상태 코드 반환
• 30초 이내 응답
• 시스템이 최대 3회 자동 재시도
• 웹훅 재시도로 인해 데이터 처리가 지연될 수 있습니다 (최대 ~3초)