내 조직 목록 조회

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

인증된 사용자가 하나의 애플리케이션에서 전환할 수 있는 조직을 slug 순서로 최대 100개까지 나열합니다. 나열되는 조직은 사용자가 활성 멤버십을 가지고 있고, 조직이 활성 상태이며, 애플리케이션이 해당 조직에 대해 사용 설정되어 있는 조직입니다. 이 목록은 조직 전환기에 표시되는 목록이자 호스팅된 조직 선택기가 로그인 시 제공하는 목록과 같으므로, 애플리케이션이 사용할 수 없는 조직은 표시되지 않습니다. 현재 조직으로 표시되는 항목은 없습니다. 애플리케이션 토큰이 연결된 조직은 토큰의 org_id 클레임입니다. 조회는 아무것도 변경하지 않으며 최근에 검증된 세션을 요구하지 않습니다. 인증된 사용자의 __Host-idp_session 쿠키가 필요하며, 쿠키가 없거나 만료되었거나 취소된 경우 401 unauthenticated를 반환합니다.

@keenauth/js를 사용하는 경우: await keenauth.organizations.listMine().

요청

헤더:

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

쿼리 매개변수:

매개변수	필수	설명
`client_id`	예	조직 전환기가 실행되는 자사 애플리케이션의 `client_id`.

본문 없음.

응답

{"data": [...], "truncated": false}와 함께 200 OK를 반환합니다.

각 항목: id (org_…, 토큰의 org_id 클레임 및 organization 매개변수와 같은 형식), slug, name (제어 문자와 양방향 문자를 제거한 표시 이름이며, 조직에 이름이 없으면 slug를 사용합니다. 일반 텍스트로 렌더링하십시오). 사용자에게 나열된 수보다 더 많은 해당 조직이 있으면 truncated는 true입니다.

오류

상태	코드	발생 조건
401	`unauthenticated`	유효한 세션 쿠키가 없습니다.
403	`headless_not_allowed`	애플리케이션이 제3자 애플리케이션입니다.
422	`validation_failed`	`client_id`가 없거나, 비어 있거나, 255자보다 길거나, 두 번 이상 전달되었거나, 알 수 없는 값입니다(`/client_id`).
503	`temporarily_unavailable`	멤버십 디렉터리가 응답하지 않았습니다. 나중에 다시 시도하십시오.

예시

curl "https://example.keenauth.app/fapi/v1/me/organizations?client_id=app_01j9zzzzzzzzzzzzzzzzzzzz" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
      "slug": "acme",
      "name": "Acme"
    }
  ],
  "truncated": false
}

개인정보

이 엔드포인트는 개인정보를 다룹니다: 조직 멤버십과 초대. KeenAuth API의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.