본문으로 건너뛰기

Place & Food API

오늘의 기운 기반 장소 추천 및 음식 추천 엔드포인트입니다.

엔드포인트 목록​

메서드경로설명인증
GET/api/place/recommend오늘 기운 기반 장소 키워드 추천필요
GET/api/food/recommend오늘 기운 기반 음식 추천필요

GET /api/place/recommend​

오늘의 기운에 맞는 Kakao Maps 검색 키워드 4개를 반환합니다. 프론트엔드가 이 키워드로 Kakao Local API를 직접 호출해 주변 장소를 검색합니다.

동작:

  • 오늘의 기운(daily_energy) 기반으로 GPT가 생성
  • 당일 재요청 시 캐시에서 즉시 반환 (GPT 재호출 없음)

에러:

상황HTTP에러 코드
사주 미등록404SAJU_NOT_FOUND
오늘 기운 미생성404DAILY_ENERGY_NOT_FOUND

GET /api/food/recommend​

오늘의 기운을 기반으로 부족한 오행을 보완하는 음식을 추천합니다.

동작:

  • DB 캐시 히트 시 즉시 반환
  • 미스 시 GPT 호출 후 저장 (사용자·날짜 기준 캐시)
  • 추천 음식 1~5위, 피해야 할 음식, 1위 메뉴 장보기 목록 반환

에러:

상황HTTP에러 코드
사주 미등록404SAJU_NOT_FOUND