Health Check

API의 가용 여부와 API 키 유효성을 함께 확인합니다. 연동 초기 점검이나 모니터링에 사용합니다.

GET /partner/v1/health

Request

curl -H 'x-partner-api-key: YOUR_API_KEY' \
  'https://api.lemong.ai/partner/v1/health'

Response

{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "status": "ok",
    "server_time": "2026-08-14T00:00:00+09:00",
    "version": "v1"
  }
}

Description

필드	타입	설명
status	string	항상 ok
server_time	string (KST)	서버 시각
version	string	API 버전 (v1)

TIP

• 이 엔드포인트도 API 키가 필요하므로, 200이면 키도 유효하다는 의미입니다.
• data의 내부 status는 현재 서버의 상태입니다.

Error Case

{
  "status": "PARTNER_API_KEY_REQUIRED",
  "status_code": 401,
  "message": "요청을 처리할 수 없습니다."
}

status_code	status	이 API 에서 발생하는 경우
401	PARTNER_API_KEY_REQUIRED	x-partner-api-key 헤더 누락
401	PARTNER_API_KEY_INVALID	등록되지 않은 키
401	PARTNER_API_KEY_INACTIVE	폐기된 키
401	PARTNER_API_KEY_EXPIRED	만료된 키
403	PARTNER_API_FORBIDDEN	비활성화된 협력사 (담당자 문의)
404	PARTNER_API_NOT_FOUND	잘못된 URL 경로
429	PARTNER_API_RATE_LIMITED	호출 제한 초과 (분당 100회)
500	PARTNER_API_INTERNAL_ERROR	서버 오류