# 내 프로필 가져오기

`GET /fapi/v1/me` · 환경의 로그인 호스트에서 호출

인증된 사용자 본인의 프로필을 반환합니다. 사용자가 변경할 수 있는 7개 필드와 `user_metadata`가 포함됩니다. 연락처 정보, 검증 상태, `app_metadata`, 관리용 필드는 반환되지 않습니다. `ETag` 헤더는 프로필 버전이며, 변경을 조건부로 만들려면 `If-Match`에 이 값을 보내십시오. 사용자의 `__Host-idp_session` 쿠키가 필요하며, 쿠키가 없거나 만료되었거나 취소된 경우 `401 unauthenticated`를 반환합니다. 다른 출처에 있는 자사 앱은 대신 프론트 API 액세스 토큰(DPoP 증명과 함께 `Authorization: DPoP <token>`)을 보낼 수 있습니다. 자세한 내용은 [프론트 API 액세스 토큰](/docs/api/fapi/front-api-token)을 참조하십시오. 최근 재검증은 필요하지 않습니다. 이 응답은 개인정보이므로 캐시되지 않습니다.

## 요청

헤더:

| 헤더 | 필수 | 설명 |
| --- | --- | --- |
| `Idp-Client` | 예 | SDK 식별자입니다. |

본문이 없습니다.

## 응답

`ETag` 헤더가 포함된 `200 OK`(프로필 버전, 예: `"8"`):

| 필드 | 유형 | 설명 |
| --- | --- | --- |
| `id` | string | 사용자 식별자(`usr_…`)입니다. 토큰의 `sub`와 같습니다. |
| `given_name` | string | 이름입니다. |
| `family_name` | string | 성입니다. |
| `name` | string | 전체 이름입니다. |
| `picture` | string | 사진 URL(`https`)입니다. |
| `locale` | string | 언어(BCP 47 태그)입니다. |
| `zoneinfo` | string | 시간대(IANA 이름)입니다. |
| `username` | string | 사용자 이름입니다. |
| `user_metadata` | object | 사용자 본인의 메타데이터입니다. 항상 JSON 객체이며, 비어 있으면 `{}`입니다. |

값이 없는 필드는 응답에서 생략됩니다.

```json
{
  "id": "usr_01jbz6x8kq3m2n4p5r6s7t8v9w",
  "given_name": "Ada",
  "family_name": "Lovelace",
  "name": "Ada Lovelace",
  "locale": "en-GB",
  "zoneinfo": "Europe/London",
  "username": "ada",
  "user_metadata": {
    "theme": "dark"
  }
}
```

## 오류

| 상태 | 코드 | 발생 조건 |
| --- | --- | --- |
| 401 | `unauthenticated` | 유효한 세션 쿠키가 없습니다. |
| 404 | `not_found` | 계정을 읽을 수 없습니다(예: 차단되었거나 삭제 진행 중). |
| 503 | `service_unavailable` | 사용자 디렉터리를 일시적으로 사용할 수 없습니다. `Retry-After` 초 이후에 다시 시도하십시오. |

## 예제

```bash
curl https://example.keenauth.app/fapi/v1/me \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

## 개인정보

이 엔드포인트는 개인정보를 다룹니다. 최종 사용자 프로필이 해당합니다. [KeenAuth API의 개인정보](/docs/policies/personal-data)에서 저장되는 항목, 보관 기간, 삭제 방법을 확인할 수 있습니다. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.