개발자 문서
645.live 연동 가이드
645.live는 공개 로또 6/45 조회 API, 마크다운 대응 문서, 같은 도메인 MCP 탐색, 기존 Better Auth와 TrailBase 기반 회원 스캔 흐름을 제공합니다.
최근 회차 스냅샷, 통계 개요, 로그인 제공자 정보, 서비스 상태를 안정적인 기계 판독 형식으로 가져오려면 공개 REST API를 사용하면 됩니다. MCP를 이미 지원하는 에이전트 플랫폼이라면 같은 핵심 기능을 도구 형태로 노출하는 MCP 엔드포인트를 사용할 수 있습니다.
현재 인증 모델은 단순하게 유지되어 있습니다. 공개 조회 API는 익명으로 사용할 수 있고, 회원 스캔 작업은 사용자의 기존 Better Auth 세션 쿠키가 필요합니다. OAuth 디스커버리 엔드포인트는 추후 단계에서 도입될 예정이며 아직 공개되지 않았습니다.
섹션
빠른 시작
- https://645.live/api/lotto-draws-recent.json에서 최근 회차 데이터를 조회합니다.
- https://645.live/api/stats/overview.json에서 상위 통계 요약을 가져옵니다.
- 사용자를 로그인으로 보내기 전에 https://645.live/api/auth/providers.json에서 현재 로그인 제공자를 확인합니다.
- https://645.live/api/openapi.json를 사용해 SDK나 함수 호출 스키마를 생성합니다.
섹션
공개 REST API
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /api/lotto-draws-recent.json | 최근 로또 6/45 회차 스냅샷 |
| GET | /api/lotto-draws/{round}.json | 단일 회차 구조화 스냅샷 |
| GET | /api/stats/overview.json | 기존 TrailBase 기반 서비스에서 만든 통계 허브 요약 |
| GET | /api/auth/providers.json | 현재 활성화된 Better Auth 로그인 제공자 목록 |
| GET | /api/status.json | 기계 판독용 서비스 상태 문서 |
| GET | /api/openapi.json | 공개 REST 인터페이스용 OpenAPI 설명서 |
섹션
MCP와 WebMCP
원격 MCP 탐색은 https://645.live/.well-known/mcp에서 제공되며 https://645.live/mcp 별칭도 함께 지원합니다. MCP Apps 메타데이터는 ui:// 리소스를 사용해, 지원하는 호스트에서 통계·회차 상세·회원 스캔 데이터를 가벼운 UI 표면으로 렌더링할 수 있습니다.
navigator.modelContext를 사용할 수 있는 브라우저에서는 WebMCP도 함께 등록됩니다. 브라우저 쪽 도구는 원격 MCP 서버와 같은 기능 모델을 따르며, 사용자의 실제 세션 상태와 연결됩니다.
섹션
인증 동작
- 공개 조회 API는 별도 인증 없이 사용할 수 있습니다.
- 회원 스캔 관련 작업은 645.live의 기존 Better Auth 세션 쿠키를 사용합니다.
- 현재 이메일/비밀번호 로그인을 지원하며, 소셜 로그인 제공자는 Better Auth 설정에 따라 런타임에 노출됩니다.
- OAuth/OIDC 디스커버리 메타데이터는 추후 Better Auth 확장 단계에서 도입될 예정입니다.
섹션
오류와 지원
- 공개 API 오류는 HTML 대체 페이지 대신 error, code, message, hint 필드를 가진 JSON으로 반환됩니다.
- 자동화 도구가 재시도 전에 상태를 확인해야 한다면 /api/status.json을 사용합니다.
- 공개 지원 채널과 구현 이슈 제보는 /contact를 사용합니다.
섹션