개발자센터
잼쿠봇과 연결하는 나만의 앱과 도구를 만들어 보세요. 스트리머가 동의한 채널의 명령어·룰렛·SR·포인트를 API로 다루고 채널 이벤트를 실시간으로 받을 수 있습니다.
문서 둘러보기
빠른 시작앱 등록부터 스트리머 동의, 토큰 교환과 첫 API 호출까지 순서대로 따라 합니다.인증OAuth 인가 코드 흐름, 토큰 발급·갱신과 권한(Scope)을 설명합니다.API 레퍼런스명령어·룰렛·SR·포인트 API의 요청·응답과 공통 규칙입니다.실시간 이벤트WebSocket으로 명령어 사용과 룰렛 결과를 실시간으로 받습니다.
기본 정보
| 항목 | 값 |
|---|---|
| API 기본 주소 | https://jamkubot.com/api/v1/developer |
| 인증 | OAuth2 인가 코드 방식 · Authorization: Bearer ACCESS_TOKEN |
| 인가 화면 | GET https://jamkubot.com/developers/oauth/authorize |
| 토큰 발급·갱신 | POST https://jamkubot.com/developers/oauth/token |
| 토큰 폐기 | POST https://jamkubot.com/developers/oauth/revoke |
| 토큰 정보 | GET https://jamkubot.com/api/v1/developer/me — 토큰의 채널·권한·만료 시각 |
| 호출 한도 | 앱 하나당 분당 30회(연결된 모든 채널 합산) · X-RateLimit-* 헤더 — 제한 |
| 실시간 이벤트 | wss://jamkubot.com/api/v1/developer/ws |
| 요청·응답 | JSON — 형식과 오류는 공통 사항을 참고하세요. |
API 목록
앱이 호출할 수 있는 API와 필요한 권한입니다. 권한은 권한 (Scope)에서 자세히 설명합니다.
| 메서드 | 경로 | 권한 | 문서 |
|---|---|---|---|
| GET | /api/ | 유효한 액세스 토큰 (Scope 불필요) | 토큰 정보 조회 |
| GET | /api/ | commands:read | 명령어 목록 조회 |
| POST | /api/ | commands:write | 명령어 추가 |
| PUT | /api/ | commands:write | 명령어 수정 |
| DELETE | /api/ | commands:write | 명령어 삭제 |
| GET | /api/ | roulette:read | 룰렛 목록 조회 |
| GET | /api/ | roulette:read | 룰렛 조회 |
| POST | /api/ | roulette:write | 룰렛 만들기 |
| PUT | /api/ | roulette:write | 룰렛 수정 |
| DELETE | /api/ | roulette:write | 룰렛 삭제 |
| GET | /api/ | roulettelog:read | 룰렛 내역 조회 |
| GET | /api/ | sr:control | SR 상태 조회 |
| POST | /api/ | sr:control | 재생 제어 |
| GET | /api/ | points:read | 포인트 목록 조회 |
| GET | /api/ | points:read | 시청자 포인트 조회 |
| WS | /api/ | events:subscribe | 연결 |
연동하다 막히셨나요?
오류 코드와 토큰·권한 상태를 먼저 확인해 주세요. 해결되지 않으면 디스코드로 문의해 주세요.