계정 관리

개요

계정 엔드포인트를 통해 사용자는 자신의 프로필, 비밀번호, 설정, API 키를 관리할 수 있습니다. 모든 엔드포인트는 인증이 필요합니다.

기본 URL: https://<backend-host>/api/v1

프로필 관리

POST /api/v1/auths/update/profile

현재 사용자의 표시 이름, 프로필 이미지, 커스텀 정보 필드를 업데이트합니다.

{
"name": "Updated Name",
"profile_image_url": "https://...",
"info": {
  "logo_url": "s3://bucket/path/to/logo"
}
}

{
"id": "user-uuid",
"name": "Updated Name",
"email": "user@example.com",
"profile_image_url": "https://...",
"info": {...}
}

비밀번호 관리

POST /api/v1/auths/update/password

현재 사용자의 비밀번호를 변경합니다. 신뢰된 헤더(SSO) 인증이 활성화된 경우 사용할 수 없습니다.

{
"password": "current-password",
"new_password": "new-password"
}

true

API 키

API 키는 JWT 토큰의 장기 대안입니다. 만료되지 않으며 세션 로그아웃 후에도 유효합니다.

POST /api/v1/auths/api_key

현재 사용자의 API 키를 생성하거나 교체합니다.

{
"api_key": "sk-..."
}

GET /api/v1/auths/api_key

현재 사용자의 API 키를 가져옵니다.

{
"api_key": "sk-..."
}

DELETE /api/v1/auths/api_key

현재 사용자의 API 키를 삭제합니다. 키는 즉시 무효화됩니다.

true