IonoFlux API

우주기상, 전리층 지도, 관측 전파, HF 경로 예측을 위한 무료 REST API입니다. 모든 응답은 JSON이며 시각은 UTC, 주파수는 MHz 단위입니다.

빠른 시작

모든 호출에는 API 키가 필요합니다. 로그인한 뒤 계정 페이지에서 무료 키를 만들고 X-API-Key 헤더에 담아 보내세요.

curl "https://ionoflux.runvia.app/v1/propagation/path?from=Seoul&to=New%20York&frequency=14.074" \
  -H "X-API-Key: ifx_your_key"
// JavaScript
const res = await fetch("https://ionoflux.runvia.app/v1/space-weather/current", {
  headers: { "X-API-Key": process.env.IONOFLUX_KEY },
});
const { solar, geomagnetic } = await res.json();
# Python
import requests
r = requests.get("https://ionoflux.runvia.app/v1/propagation/forecast",
                 params={"from": "PM37", "to": "FN20", "hours": 24},
                 headers={"X-API-Key": "ifx_your_key"})
for hour in r.json()["hours"]:
    print(hour["time"], hour["best_band"], hour["best_reliability"])

주요 엔드포인트

GET /v1/propagation/path?from=Seoul&to=New%20York&frequency=14.074두 지점 사이의 경로 예측(좌표, 메이든헤드 로케이터 또는 지명)
GET /v1/propagation/forecast?from=PM37&to=FN20&hours=24경로의 시간별 밴드 신뢰도(최대 72시간)
GET /v1/space-weather/current현재 지표 전체를 한 번에
GET /v1/ionosphere/muf?format=geojson전 세계 MUF·foF2 격자(JSON 또는 GeoJSON)
GET /v1/observations/live?minutes=15&band=20m최근 몇 분간 수신된 경로(PSK Reporter + WSPR)
GET /v1/geomagnetic/kpKp 기록과 3일 예보
GET /v1/alertsNOAA 경보와 감지된 스포라딕 E 개방

사용 한도

무료 키는 UTC 기준 하루 1,000회까지 요청할 수 있습니다. 모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 헤더가 포함됩니다.

출처 표기

응답에는 원본 출처와 라이선스가 포함됩니다. 데이터를 공개할 때는 원 제공 기관(NOAA SWPC, GFZ, SILSO, GIRO, PSK Reporter, WSPRnet, OpenStreetMap)을 표기해 주세요.