Hybridbox 공개 API

인증

REST API는 OAuth 2.0 bearer 액세스 토큰을 사용합니다. 브라우저 또는 웹 앱 연동에서 토큰을 얻는 방법:

Hybridbox 웹 앱 공개 클라이언트로 표준 OAuth 인증 코드 흐름을 시작합니다.
사용자를 Hybridbox 인증 엔드포인트로 보내고 일반 OpenID 범위를 요청합니다.
사용자가 로그인한 뒤 반환된 인증 코드를 Hybridbox 토큰 엔드포인트에서 토큰으로 교환합니다. 공개 브라우저 클라이언트는 PKCE를 사용해야 하며, 서버 측 웹 앱은 백엔드에서 코드 교환을 수행해야 합니다.
토큰 응답에서 access_token을 읽습니다.

인증된 REST API 요청에 액세스 토큰을 사용합니다.

Authorization: Bearer <access_token>

API는 토큰 발급자를 검증하고 Hybridbox 웹 앱 클라이언트를 포함한 허용된 공개 클라이언트 ID를 요구합니다. 엔드포인트 페이지에는 인증된 사용자 또는 그룹에 필요한 추가 권한이 표시됩니다.

OpenAPI 사양

전체 공개 API 계약을 openapi.json 파일로 다운로드하세요.

⌘I