내 프로필 가져오기

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

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

요청

헤더:

헤더	필수	설명
`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 객체이며, 비어 있으면 `{}`입니다.

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

{
  "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` 초 이후에 다시 시도하십시오.

예제

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의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 확인할 수 있습니다. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.