Data API 시작하기

SOOP h66rogi 채널의 방송 상태와 채팅을 읽을 수 있습니다. 방송 중에는 WebSocket으로 새 채팅을 받고, 지난 방송의 채팅은 HTTP로 조회합니다.

주소	용도
https://data-api.rogi.chat	HTTP API
wss://data-api.rogi.chat/v1/chat/stream	실시간 WebSocket
OpenAPI 3.1 명세	HTTP 응답·오류 스키마

인증 없이 사용할 수 있습니다. 응답과 이벤트는 JSON이며 시각은 RFC 3339 UTC 형식입니다. 별도 SDK나 Socket.IO 클라이언트는 필요하지 않습니다.

첫 요청

curl -fsS https://data-api.rogi.chat/v1/broadcasts/current

live가 true이면 방송 중이고, false이면 방송이 꺼져 있습니다. null이면 현재 방송 여부를 확인할 수 없습니다. 채팅 수집 연결은 별도의 collection 필드에서 확인하세요. 필드 설명

채팅 읽기

• 새 채팅: WebSocket 연결과 재접속
• 최근 채팅: GET /v1/chats/recent
• 지난 방송: 방송 목록과 채팅 기록

최근 채팅의 cursor와 지난 방송의 cursor는 서로 호환되지 않습니다. 각 응답의 nextCursor를 같은 경로의 다음 요청에 그대로 전달하세요.

사용 시 알아둘 점

실시간·최근 채팅은 최대 24시간 또는 Redis stream 10,000개 항목 범위에서 제공됩니다. 지난 방송 채팅에는 시간 기준 삭제 정책이 없지만, 보관 기능이 시작되기 전의 기록은 조회할 수 없습니다. 보관 채팅의 complete는 false이므로 전체 방송 채팅이 빠짐없이 저장됐다는 의미로 사용하지 마세요. 보관 필드 설명

API 전체 요청 제한은 초당 20회, 순간 최대 60회입니다. 동시 WebSocket 연결은 최대 32개입니다. 제한과 재시도 방법은 오류와 제한을 참고하세요.