빠른 시작

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

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

Adobe Developer Console에서 새 프로젝트를 생성하고 Frame.io V4 API를 추가합니다.

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

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

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 요청을 전송하여 해당 코드를 액세스 토큰으로 교환합니다.

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

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
}

4단계: 첫 API 요청 수행

액세스 토큰을 사용하여 /v4/me 엔드포인트를 호출하는 것으로 시작하세요.

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에 요청하세요:

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

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

다음 단계

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

• 인증 가이드
• 계정, 프로젝트, 작업 영역
• API 참조
• Postman 컬렉션