사용자 조회
GET /v1/users/{user_id} · 권한 users:read
사용자 한 명을 반환합니다. 다른 환경의 사용자, 존재하지 않는 사용자, 삭제된 사용자는 모두 404를 반환합니다. 환경 간에는 사용자 존재 여부가 절대 공개되지 않습니다.
요청
| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
user_id |
path | 예 | 사용자 ID이며 접두사는 usr_입니다. |
include |
query | 아니요 | deleted로 설정하면 404 대신 삭제된 사용자의 묘비(tombstone) 정보를 반환합니다. |
include=deleted를 사용하면 삭제된 사용자에 대해 410과 함께 deleted_at, deletion_id, backups_purged_by(백업에서 데이터가 삭제되는 기한)를 반환하며, 병합된 사용자의 경우 merged_into도 포함됩니다. 한 번도 존재한 적이 없는 사용자는 여전히 404를 반환합니다.
응답
200 OK입니다. 본문은 사용자 객체입니다. ETag 헤더에는 사용자 버전이 포함됩니다.
키에 users:read_pii 권한이 없으면 개인 정보가 마스킹됩니다. email은 a***@e***.com이 되고, phone_number는 마지막 2자리만 유지합니다(+**********67). name, given_name, family_name, middle_name, nickname은 이니셜(A. L.)이 되며, username은 첫 글자만 유지합니다(a***). birthdate는 ****-**-**가 되고, address는 {"redacted": true}가 됩니다. user_metadata와 app_metadata는 마스킹되지 않습니다.
{
"id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
"kind": "regular",
"status": "active",
"external_id": null,
"username": null,
"name": "Ada Lovelace",
"email": "ada@example.com",
"email_verified": true,
"phone_number": null,
"phone_verified": false,
"user_metadata": {},
"app_metadata": {},
"created_via": "admin_api",
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z",
"last_sign_in_at": null,
"deletion_requested_at": null,
"deletion_due_at": null
}
오류
모든 오류는 안정적인 code를 포함한 application/problem+json 본문입니다.
| HTTP | code |
발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 사용자가 없거나 ID 형식이 잘못되었습니다. |
| 410 | user_deleted |
사용자가 삭제되었고 include=deleted를 요청했습니다. 본문에는 deleted_at, deletion_id, backups_purged_by 및 병합된 사용자의 경우 merged_into가 포함됩니다. |
| 401 | unauthenticated |
API 키가 없거나, 잘못되었거나, 취소되었습니다. |
| 403 | insufficient_permissions |
키에 users:read 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After를 따르십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |
예시
curl https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
개인 정보
이 엔드포인트는 개인 정보(최종 사용자 프로필)를 처리합니다. KeenAuth API의 개인 정보에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특수 범주의 개인 정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.