> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Hybridbox 공개 API

> Hybridbox 공개 API를 사용하여 계정, 도메인, 메일함, DNS 레코드, 전달 규칙, 마스터 비밀번호, 태그, 워크스페이스, 전용 IP를 관리할 수 있습니다.

# Hybridbox 공개 API

## 인증

REST API는 OAuth 2.0 bearer 액세스 토큰을 사용합니다.

브라우저 또는 웹 앱 연동에서 토큰을 얻는 방법:

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

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

```http theme={null}
Authorization: Bearer <access_token>
```

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

## OpenAPI 사양

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