API 레퍼런스
세션
활성 사용자 세션을 조회하고 관리합니다. 감사 및 의심스러운 활동의 강제 로그아웃에 유용합니다.
Session 객체
json
{
"id": "sess_abc123",
"userId": "usr_abc123",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...",
"ipAddress": "203.0.113.1",
"country": "KR",
"createdAt": "2026-01-15T10:30:00Z",
"lastActiveAt": "2026-01-15T11:45:00Z",
"expiresAt": "2026-01-16T10:30:00Z"
}GET
/v1/dashboard/sessions활성 세션 목록
프로젝트의 모든 활성 세션을 나열합니다. secret key가 필요합니다.
응답
json
{
"sessions": [
{
"id": "sess_abc123",
"userId": "usr_abc123",
"userAgent": "Chrome/120...",
"ipAddress": "203.0.113.1",
"lastActiveAt": "2026-01-15T11:45:00Z"
}
],
"total": 15
}GET
/v1/dashboard/users/:userId/sessions사용자 세션 목록
특정 사용자의 모든 활성 세션을 나열합니다.
응답
json
{ "sessions": [...], "total": 3 }DELETE
/v1/dashboard/sessions/:sessionId세션 취소
특정 세션을 강제 로그아웃합니다. 해당 기기에서 즉시 로그아웃됩니다.
응답
json
{ "success": true }DELETE
/v1/dashboard/users/:userId/sessions사용자 전체 세션 취소
특정 사용자의 모든 기기에서 전체 세션을 강제 로그아웃합니다.
응답
json
{ "revoked": 3 }