Skip to main content
GET
운세 통계 조회
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
운세 생성 관련 통계를 조회합니다. 모델별 사용량, 캐시 히트율, 평균 점수 등을 확인할 수 있습니다.

Query 파라미터

string
조회 시작 날짜입니다. ISO 8601 형식(YYYY-MM-DD)입니다. 기본값은 30일 전입니다.
string
조회 종료 날짜입니다. ISO 8601 형식(YYYY-MM-DD)입니다. 기본값은 오늘입니다.
string
특정 운세 유형만 조회합니다. daily, yearly, monthly 중 하나입니다.

Response

성공

운세 통계 조회에 성공하면 FortuneReport 객체가 반환됩니다.

실패


요청 예시


응답 예시


FortuneReport 객체


캐시 히트율 최적화

캐시 히트율을 높이면 비용을 절감하고 응답 속도를 개선할 수 있습니다.
  • 동일한 조건 사용: profile_id, fortune_type, fortune_date, model 조합이 동일하면 캐시가 적용됩니다.
  • 배치 생성 활용: 자정에 배치 API로 미리 생성하면 사용자 요청 시 캐시된 결과를 반환합니다.
  • 오늘의 운세 API 사용: 오늘의 운세 엔드포인트는 자동으로 캐시를 활용합니다.