인증
Management API 호출은 Authorization: Bearer sk_live_* 또는 Authorization: Bearer sk_test_*를 사용합니다. 키의 범위는 확인된 Tenant로 제한됩니다. Organization 리소스는 요청한 Organization이 해당 Tenant에 속하는지도 확인합니다.
curl https://xid.dev/v1/users \
-H 'Authorization: Bearer sk_live_xxx'리소스
| 리소스 | 기능 | 상태 |
|---|---|---|
/v1/users |
사용자를 생성, 조회, 업데이트, 차단, 차단 해제, 내보내기, 제거합니다. | 구현됨 |
/v1/organizations |
조직, 도메인, 브랜딩, 설정을 관리합니다. | 구현됨 |
/v1/organizations/:orgId/memberships |
멤버를 조회, 추가, 역할 업데이트, 제거합니다. | 구현됨 |
/v1/organizations/:orgId/invitations |
초대를 생성(bulk 제한 있음), 폐기, 조회합니다. | 구현됨 |
/v1/sessions |
사용자 세션을 조회, 가져오기, 폐기합니다. | 구현됨 |
/v1/applications |
OAuth 클라이언트, 리디렉션 URI, 권한 부여, 토큰 정책, 비밀값을 등록합니다. | 구현됨 |
/v1/connections |
Upstream 엔터프라이즈 SSO 연결을 관리합니다. | 구현됨 |
/v1/directories |
SCIM 디렉터리를 만들고 디렉터리 토큰을 순환합니다. | 구현됨 |
/v1/roles |
사용자 정의 역할을 생성, 조회, 업데이트, 삭제합니다. | 구현됨 |
/v1/permissions |
권한을 생성, 조회, 업데이트, 삭제합니다. | 구현됨 |
/v1/project-grants |
프로젝트 권한 부여를 생성, 나열, 조회, 취소 및 삭제합니다. | 구현됨 |
/v1/user-grants |
범위가 지정된 사용자 권한 부여를 할당, 나열, 조회, 취소 및 삭제합니다. | 구현됨 |
/v1/organizations/:orgId/domains |
조직 도메인을 나열, 생성 및 제거합니다. | 구현됨 |
/v1/organizations/:orgId/custom-hostnames |
사용자 정의 호스트 이름을 생성, 검사, 새로 고침 및 제거합니다. | 구현됨 |
/v1/organizations/:orgId/audit-events |
커서 페이지 매김을 사용하여 조직 감사 이벤트를 읽습니다. | 구현됨 |
/v1/webhooks |
Webhook 엔드포인트를 생성, 조회, 업데이트, 삭제합니다. | 구현됨 |
/v1/api-keys |
조직 API 키를 생성, 조회, 폐기합니다. | 구현됨 |
/v1/organizations/:orgId/scim-targets |
아웃바운드 SCIM 대상을 생성, 업데이트, 동기화 및 제거합니다. | 구현됨 |
페이지네이션 및 오류
목록 엔드포인트는 데이터 배열과 커서 메타데이터를 반환합니다. 오류는 안정적인 코드, 읽기 쉬운 메시지, 필드 검증용 선택적 메타데이터를 포함한 구조화된 JSON을 사용합니다.