> This page is for 플랫폼, version V4 (default).
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 실험적: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - 레거시: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# 빠른 시작

이 가이드에서는 처음으로 성공적인 Frame.io V4 API 호출을 수행하는 가장 빠른 경로를 다룹니다. Adobe Developer Console에서 프로젝트를 생성하고, 자격 증명을 발급받은 후, 첫 API 요청을 수행하게 됩니다.

---

## 1단계: Adobe Developer Console에서 프로젝트 생성 및 Frame.io V4 API 추가

[Adobe Developer Console](https://developer.adobe.com/developer-console/)에서 새 프로젝트를 생성하고 Frame.io V4 API를 추가합니다.

---

> **Tip**
>
> 이 안내서는 인증을 위해 OAuth 2.0 웹 앱을 사용합니다. 다른 인증 방법에 대한 정보는 \*\*[인증 안내서](guides/authentication/overview)\*\*를 참조하세요.

## 2단계: 애플리케이션 구성

애플리케이션 유형으로 OAuth 웹 앱을 선택하고 리디렉션 필드를 설정합니다.

|                 |                                                                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **URI 리디렉션**    | Adobe IMS에서 OAuth 응답을 받는 애플리케이션의 경로입니다. 사용자가 로그인하고 액세스를 승인한 후 Adobe IMS는 쿼리 문자열에 인증 코드와 함께 이 URL로 사용자를 리디렉션하며, 앱은 이를 액세스 토큰으로 교환합니다. |
| **URI 패턴 리디렉션** | 기본 리디렉션 URI 외에 추가 리디렉션 URL과 일치하는 패턴입니다. 이는 앱이 여러 환경에서 실행되거나 동적 라우팅을 사용하는 경우 유용합니다. 여러 패턴은 쉼표로 구분된 목록으로 제공해야 합니다.                     |

---

## 3단계: 인증

사용자를 Adobe IMS 권한 부여 엔드포인트로 리디렉션하여 OAuth 흐름을 시작합니다.

```
  https://ims-na1.adobelogin.com/ims/authorize/v2
  ?client_id={CLIENT_ID}
  &redirect_uri={REDIRECT_URI}
  &scope=offline_access,openid,email,profile,additional_info.roles
  &response_type=code

```

사용자가 로그인하고 액세스를 승인하면, Adobe IMS는 쿼리 문자열에 권한 부여 코드를 포함하여 구성된 리디렉션 URI로 다시 리디렉션합니다. IMS 토큰 엔드포인트에 POST 요청을 전송하여 해당 코드를 액세스 토큰으로 교환합니다.

\


다음은 예시 요청 및 응답과 함께 매개변수 정의 목록입니다.

| 매개 변수             | 필수 여부            | 설명                                                         |
| ----------------- | ---------------- | ---------------------------------------------------------- |
| **code**          | 예                | 사용자가 애플리케이션에 인증할 때 `redirect_uri`로 반환되는 code 쿼리 문자열의 값입니다. |
| **grant\_type**   | 예                | 값은 항상 `authorization_code`여야 합니다.                          |
| **authorization** | 기밀 클라이언트에 필수입니다. |                                                            |
| **요청 예시**         |                  |                                                            |

```
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
  -H 'Authorization: Basic {AUTHORIZATION}' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'code={CODE}&grant_type=authorization_code'
```

**응답 예시**

```
{
    "access_token": "{ACCESS_TOKEN}",
    "refresh_token": "{REFRESH_TOKEN}",
    "sub": "B0DC108C5CD449CA0A494133@c62f24cc5b5b7e0e0a494004",
    "id_token": "{ID_TOKEN}",
    "token_type": "bearer",
    "expires_in": 86399
}
```

> **SDK 지원**
>
> Python 및 TypeScript SDK에는 OAuth 핸드셰이크, 토큰 교환, 자동 토큰 새로 고침을 처리하는 인증 모듈이 포함되어 있습니다. 각 모듈에 대한 자세한 내용은 여기에서 확인할 수 있습니다.
>
> [**Python**](/platform/docs/sdk-reference/python-sdk-reference) | [**TypeScript**](/platform/docs/sdk-reference/type-script-sdk-reference)

---

## 4단계: 첫 API 요청 수행

액세스 토큰을 사용하여 [`/v4/me`](/platform/api-reference/users/show) 엔드포인트를 호출하는 것으로 시작하세요.

```
curl https://api.frame.io/v4/me \
-H "Authorization: Bearer <token>"
```

이 요청은 토큰 및 사용자 정보를 확인하기 위해

**Adobe IMS API**

를 호출합니다.

성공적인 요청은 `user_id`, 이름, 이메일 등 인증된 사용자에 대한 세부 정보를 반환합니다. 이를 사용하여 인증 흐름이 예상대로 작동하는지 확인하세요.

대부분의 V4 API 엔드포인트는 `account_id`를 필요로 하지만 이는 `/v4/me`에서 반환되지 않습니다. `account_id`를 얻으려면 [`/v4/accounts`](/platform/api-reference/accounts/index)에 요청하세요:

```
curl https://api.frame.io/v4/accounts \
-H "Authorization: Bearer <token>"
```

이렇게 하면 인증된 사용자가 이용할 수 있는 계정 목록이 반환됩니다. 후속 API 요청 시 이 응답에서 받은 `account_id`를 사용하세요.

> **사용자 ID vs 계정 ID**
>
> \*\*`user_id`\*\*는 개인으로서의 귀하를 식별하며, \*\*`account_id`\*\*는 귀하가 속한 조직을 나타냅니다. 대부분의 V4 엔드포인트는 계정 수준에서 작동합니다.

---

## 다음 단계

인증 설정과 `account_id`가 확보되었으므로, 이제 Frame.io API로 작업을 시작할 준비가 완료되었습니다. 다음 리소스들이 시작하는 데 도움이 될 수 있습니다.

* [인증 가이드](/platform/docs/guides/authentication/overview)
* [계정, 프로젝트, 작업 영역](/platform/v4/docs/guides/accounts-projects-and-workspaces)
* [API 참조](/platform/v4/api-reference/account-permissions/index)
* [Postman 컬렉션](/platform/docs/guides/postman-collection)