개발자 API · BluePin

인증

모든 보호 엔드포인트는 API 키가 필요해요. 헤더에 키를 넣어주세요.

# Authorization 헤더 (권장) curl -H "Authorization: Bearer ac_live_..." \ "https://bluepin.ai/api/v1/risk?lat=34.31&lon=126.76&species=abalone" # 또는 X-API-Key 헤더 curl -H "X-API-Key: ac_live_..." "https://bluepin.ai/api/v1/forecast?lat=34.31&lon=126.76"

엔드포인트

자주 쓰는 엔드포인트예요. 보호 표시가 있는 것은 API 키가 필요해요.

GET /api/v1/risk · 양식장 위치의 7대 위험 종합 평가 + 대응 액션
파라미터: lat, lon, species(선택)

GET /api/v1/forecast · 7일 수온 예측 (일 단위)

GET /api/v1/redtide · 최근 적조 특보 이력 · days

GET /api/v1/parametric · 지수형 보험 트리거 백테스트 — 과거 발생빈도(burn rate)·시도별·관측소별 (인증)
파라미터: hazard(high_temp·low_salinity·low_oxygen·wave), threshold, consecutive_days, region(선택)

GET /api/v1/farms · 내 키에 연결된 양식장들의 위험 (인증)

GET /api/map/risk · 광역 현재위험 지도 데이터 — 관측소별 최신 등급 (공개) · hazard

GET /api/v1/stations · 가까운 관측소 (공개)

GET /api/v1/hazards · /species · /skill · /parametric/hazards · 카탈로그·성적표 (공개)

응답 예시 — `/api/v1/risk`

위험 종합 평가 응답은 이런 모양이에요.

{ "lat": 34.31, "lon": 126.76, "species": "abalone", "overall": "warn", "top_hazard": "high_temp", "hazards": { "high_temp": { "level": "warn", "value": 27.8, "unit": "°C", "driver": "08-12에 최고 27.8°C로 오를 것으로 보여요.", "lead_hours": 72, "actions": ["사료 공급을 줄여요", ...] }, "low_salinity": { ... }, "red_tide": { ... } } }

예측값은 참고용이에요. 출처: 국립수산과학원·기상청·국립해양조사원 공공데이터를 가공했어요.

BluePin API

인증

엔드포인트

응답 예시 — /api/v1/risk

응답 예시 — `/api/v1/risk`