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/kp | Kp 기록과 3일 예보 |
GET /v1/alerts | NOAA 경보와 감지된 스포라딕 E 개방 |
사용 한도
무료 키는 UTC 기준 하루 1,000회까지 요청할 수 있습니다. 모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 헤더가 포함됩니다.
출처 표기
응답에는 원본 출처와 라이선스가 포함됩니다. 데이터를 공개할 때는 원 제공 기관(NOAA SWPC, GFZ, SILSO, GIRO, PSK Reporter, WSPRnet, OpenStreetMap)을 표기해 주세요.