공공 농산물 가격 데이터를 실시간으로 제공
Cloudflare 캐싱으로 0.1초 응답 속도
7일/30일/365일 가격 변동 추이 시각화
최소 수집 원칙, SSL 암호화 전송
🚀 API 문서
개발자를 위한 과일바구니 API 가이드
📍 Base URL
🔍 가격 데이터 조회
GET 특정 품목의 가격 정보 및 트렌드를 조회합니다.
Query Parameters:
item_code(필수): 품목 코드 (예: 111=사과)kind_code(선택): 품종 코드 (예: 01=후지)period(선택): 조회 기간 (7/30/365일, 기본값: 7)
📊 트렌드 데이터
GET 여러 품목의 가격 트렌드를 한 번에 조회합니다.
💰 구매 추천 알고리즘
기준가 대비 가격을 분석하여 구매 시점을 추천합니다:
- 🟢 GREEN: 기준가 대비 저렴 (할인율 10% 이상)
- 🟡 YELLOW: 기준가 대비 보통 (±10% 이내)
- 🔴 RED: 기준가 대비 비쌈 (할인율 -10% 이상)
⚡ 캐싱 전략
효율적인 성능을 위해 다단계 캐싱을 적용합니다:
- 인기 품목: 15-30개 자동 사전 캐싱
- 갱신 주기: 영업시간(매시간) / 피크타임(30분) / 야간(자정)
- 캐시 TTL: 1-24시간 (시간대별 차등 적용)
🛡️ Rate Limiting
무료 사용 시 요청 제한이 있을 수 있습니다. 대량 요청은 사전 문의 바랍니다.
📦 Response Example
🔐 개인정보 처리방침
최종 업데이트: 2025-11-12
1. 수집 항목 및 목적
소셜 로그인 시 이메일·닉네임·플랫폼 고유 ID를 제공받을 수 있습니다. 서비스 이용 과정에서 광고 식별자, 접속 로그, 기기 정보가 수집될 수 있습니다. 목적은 계정 식별, 알림 전송, 서비스 개선 및 어뷰징 방지입니다.
2. 보관 및 파기
관련 법령을 제외하고 회원 탈퇴 시 즉시 파기합니다. 백업은 정기 보관 후 주기적으로 삭제됩니다.
3. 제3자 제공/처리위탁
법령상 요청 또는 서비스 제공에 필요한 범위(예: 푸시 전송·로그 분석)에 한해 필요한 정보만을 처리하며, 계약상 보안 의무를 부과합니다.
4. 이용자 권리
열람·정정·삭제·처리정지를 요청할 수 있으며, 문의는 [email protected]로 주세요.
5. 안전성 확보조치
전송 구간 SSL, 접근 권한 최소화, 키·비밀값은 서버 환경변수로 관리합니다.
📜 서비스 이용약관
1. 목적
'과일바구니'(이하 "회사")가 제공하는 서비스 이용과 관련하여 회사와 이용자 간 권리·의무 및 책임사항을 규정합니다.
2. 서비스
KAMIS 공개 자료를 가공·분석·시각화한 가격 지표 및 부가 기능을 제공합니다. 서비스 내용·운영 시간은 변경 또는 중단될 수 있습니다.
3. 책임의 한계
정보의 정확성·완전성·적시성을 보증하지 않으며, 제공 정보는 참고용입니다. 실제 거래·구매는 이용자 책임입니다.
4. 외부 링크
네이버/쿠팡 등 외부 쇼핑몰로 연결될 수 있으며, 상품·배송·환불 책임은 각 판매자에게 있습니다.
5. 개인정보
개인정보 처리방침을 따릅니다.
6. 분쟁
대한민국 법령을 따르며, 관할은 민사소송법상 법원으로 합니다.
📊 데이터 출처 및 고지
1. 출처
한국농수산식품유통공사(KAMIS) 공개 자료를 기반으로 가공·시각화하여 제공합니다.
2. 가공 방식
중복/결측 정리, 단위 표기 통일(원), 대표행 선정(품종·등급·상품번호 우선), 최근 7/30/365일 시계열 표시 및 기준가 초과 구간 강조 등의 처리를 거칩니다.
3. 지표의 성격
참고용 지표입니다. 실제 구매가는 지역·유통·행사에 따라 다를 수 있으며, 제공처/네트워크 사정으로 업데이트 지연이 발생할 수 있습니다.