변경 이력

이 문서와 Operator API · 지갑 콜백 규격의 주요 변경을 최신순으로 적습니다.

버전 규칙

문서 버전은 MAJOR.MINOR.PATCH 입니다. 지금 버전은 상단 메뉴에 표시되고, 지난 버전도 같은 메뉴에서 볼 수 있습니다.

자리	올리는 경우	연동을 고쳐야 하나요?
MAJOR	하위 호환이 깨지는 변경(필드 · 엔드포인트가 빠지거나 뜻이 바뀜). 호환이 깨지는 변경은 새 API 경로 버전(예: /operator/v2)으로 내고 함께 쓰는 기간을 둡니다.	예 — 이전 안내를 따르세요
MINOR	추가: 새 엔드포인트 · 요청 옵션 · 응답 필드 · 오류 코드 · 게임 · 콜백 reason 값	새 기능을 쓸 때만. 모르는 응답 필드 · 값은 무시하도록 구현하세요
PATCH	동작 변경 없는 문서 수정 · 보충	아니요

• 문서 버전은 API 경로 버전(/operator/v1 의 v1)과 따로 매깁니다.
• 첫 버전 이후 추가된 항목은 설명하는 자리에 1.1.0+ 같은 표시를 붙입니다.
• 오퍼레이터 쪽 조치가 필요한 변경(운영 주소, 새 필수 필드, 지원 종료 예정)은 연동 담당자에게도 미리 알려 드립니다.

1.0.0 — 2026-10-20

첫 공개 버전.

• 시작하기: 연동 개요, 연동 절차 · 환경, 인증 · 서명(테스트 벡터 포함), 공통 규약, 게임 실행 흐름.
• 심리스 지갑 콜백: balance · debit · credit · rollback — 멱등 · 타임아웃 · 재시도.
• Operator API: 게임 실행, 게임 · 로비 · 통화, 테이블, 플레이어, 라운드 · 거래 · 리포트, 오퍼레이터 설정 · 알, 딜러, 프라이빗 테이블, 변경 이력(감사), 오류 코드.
• 부록: 게임 코드, 연동 체크리스트.
• 환경 주소는 자리표시 {API_BASE} · {API_HOST} · {GAME_ORIGIN} 으로 적고, 실제 주소는 연동할 때 환경별로 발급합니다.