5분 회차 데이터를
쉽고 안정적으로 연결하세요.
GOES 태양플레어 분석센터는 외부 서비스가 최신 홀짝 결과와 회차 기록, 검증 정보를 사용할 수 있도록 공개 REST API를 제공합니다.
HTTPS · JSON · CORS 지원 · 한국시간(KST) 기준
고정된 5분 회차와
검증 가능한 결과를 제공합니다.
매 5분 정각을 기준으로 하나의 회차가 생성됩니다. 결과는 drand 공개 난수와 해당 시점에 사용할 수 있는 최신 GOES 관측 데이터 해시를 결합해 결정하며, 한 번 확정된 회차는 변경되지 않습니다. 외부 서비스는 회원에게 결과를 제공하거나 자체 분석 화면을 구성할 수 있습니다.
API 엔드포인트
기본 주소는 https://goes.kr/api/game.php이며 모든 요청은 GET 방식입니다.
?action=latest가장 최근 확정 결과?action=current최신 결과와 다음 회차?action=history&limit=100최근 회차 목록?action=round&round_id=YYYYMMDDHHMM특정 회차 조회?action=verify&round_id=YYYYMMDDHHMM회차 생성 근거 확인?action=infoAPI 기본 정보빠른 시작
승인 후 발급받은 API Key를 헤더에 넣어 호출해야 하며, 신청 시 등록한 출발지 IP에서만 요청할 수 있습니다.
fetch('https://goes.kr/api/game.php?action=current',
{ headers: { 'X-API-Key': 'goes_live_YOUR_KEY' } })
.then(response => response.json())
.then(data => {
console.log(data.round.round_id);
console.log(data.round.odd_even);
console.log(data.round.lotto_number);
});curl -H 'X-API-Key: goes_live_YOUR_KEY' \
'https://goes.kr/api/game.php?action=latest'주요 응답 필드
시간값은 UTC와 한국시간을 함께 제공하며, 외부 화면에는 scheduled_at_kst 사용을 권장합니다.
| 필드 | 형식 | 설명 |
|---|---|---|
| round_id | string | YYYYMMDDHHMM 형식의 고유 회차 |
| scheduled_at_kst | datetime | 회차 기준 한국시간 |
| status | string | 확정 회차는 RESULT |
| odd_even | string | odd 또는 even |
| lotto_number | integer | 1부터 45 사이의 생성 번호 |
| result_source | string | drand 또는 server_fallback |
| space_observed_at_kst | datetime | 결과 생성에 사용한 GOES 관측시각 |
| space_age_seconds | integer | 회차 기준 관측 데이터의 경과 시간 |
| drand_round | integer | 사용한 공개 난수 비콘 회차 |
| result_hash | hex string | 최종 결과를 결정한 SHA-256 해시 |
결과 검증 방식
API 이용자는 응답에 포함된 값으로 drand 결과를 직접 재계산할 수 있습니다.
분산 공개 난수와 GOES 데이터 해시를 사용합니다. 입력값과 최종 해시는 API에 함께 공개됩니다.
모든 drand 중계 서버에 접근하지 못할 때만 사전 공개된 서버 커밋 기반의 예비 결과를 사용하며 결과원에 명시됩니다.
연동 및 이용 원칙
안정적인 서비스 운영을 위해 다음 기준을 권장합니다.
5분 정각 직후에는 current API를 조회하고 새 round_id가 확인되면 결과를 반영하세요.
RESULT 상태로 공개된 회차는 변경되지 않으므로 round_id를 키로 안전하게 저장할 수 있습니다.
과거 패턴은 다음 결과를 보장하지 않습니다. 관련 법률과 이용자 보호 기준을 준수해 주세요.