토큰 정보 (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 같은 공통 오류는 공통 오류를 참고하세요.
이 가이드로 해결이 안 됐나요?
디스코드로 문의하기