본문으로 이동

토큰 정보 (me)

액세스 토큰이 연결된 채널과 지금 쓸 수 있는 권한, 만료 시각을 확인하는 API입니다.

목차

액세스 토큰이 어느 채널의 것인지, 지금 쓸 수 있는 권한과 만료 시각을 확인합니다. 치지직 Open API의 /open/v1/users/me와 같은 역할입니다.

토큰 정보 조회

토큰 교환 직후나 앱을 다시 시작할 때 호출해 연결된 채널을 확인합니다. 권한(Scope)이 하나도 없어도 유효한 토큰이면 호출할 수 있습니다.

GET/api/v1/developer/me권한: 유효한 액세스 토큰 (Scope 불필요)

요청

요청 파라미터가 없습니다.

GET /api/v1/developer/me
Authorization: Bearer ACCESS_TOKEN

응답

필드 타입 설명
streamer_uid string 토큰이 연결된 스트리머의 치지직 채널 UID(32자)
nickname string 잼쿠봇에 마지막으로 로그인했을 때의 채널 이름
scopes string[] 지금 쓸 수 있는 권한. 토큰 · 스트리머의 현재 동의 · 앱 선언의 교집합입니다
expires_at integer 액세스 토큰 만료 시각(Unix epoch 초)
{
  "streamer_uid": "0123456789abcdef0123456789abcdef",
  "nickname": "잼쿠",
  "scopes": ["commands:read", "events:subscribe"],
  "expires_at": 1791234567
}

scopes는 스트리머가 동의 범위를 줄이거나 앱 선언에서 권한을 빼면 줄어듭니다. 토큰을 받을 때의 scope와 다를 수 있으니 기능을 켜기 전에 이 값을 기준으로 판단하세요.

오류

상태 응답 원인
401 {"detail": "유효하지 않거나 만료된 액세스 토큰입니다"} 토큰 없음·만료·연결 해제, 또는 쓸 수 있는 권한이 하나도 남지 않음

401·429 같은 공통 오류는 공통 오류를 참고하세요.

이 가이드로 해결이 안 됐나요?

디스코드로 문의하기

명령어, 룰렛, OBS처럼 궁금한 걸 검색해 보세요.