クイックスタート

このガイドでは、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 Web App を選択し、リダイレクトフィールドを設定します。

ステップ 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>"

これにより、認証されたユーザーが利用できるアカウントのリストが返されます。この応答の account_id を後続のAPIリクエストで使用します。

次のステップ

認証が設定され、account_id が取得できたら、Frame.io APIの使用を開始する準備が整いました。開始に役立つリソースは次のとおりです：

• 認証ガイド
• Accounts, Projects, and Workspaces
• API リファレンス
• Postman コレクション