Make API Requests
最終更新日：2025-05-28 15:52:08
本セクションでは、CDNetworksメディア処理サービスへのAPI呼び出し方法について包括的な情報を提供します。開始前に、アカウントでメディア処理サービスが有効化されており、正しいAccessKeyとAccessKey Secretのペアが用意されていることを確認してください。
リクエスト構造
メディア処理サービスへのすべてのAPIリクエストは、特定のHTTPメソッド、定義済みURI、必須ヘッダー、および処理パラメータを含むリクエストボディで構成されます。
リクエストメソッド
現在、メディア処理サービスAPIは処理リクエストにPOST HTTPメソッドのみをサポートしています。
リクエストURI
メディア処理サービスAPIへのベースURIは以下の構造です：
http://<API Address>/fops
URIの構成要素は以下の表に詳細を示します：
| パラメータ | 説明 |
|---|---|
| 通信プロトコル | 現在、メディア処理サービスAPIへのリクエスト送信にはHTTPプロトコルのみがサポートされています |
| APIアドレス | オブジェクトストレージコンソール内の「管理ドメイン」とも呼ばれます。Object Storage > Bucket > Overview > Manage Domain。 |
| リソースパス | 特定のAPI機能で明示的に指定されていない限り、メディア処理リクエストのリソースパスは常に/fopsです |
URI例
リクエストヘッダー
メディア処理サービスへの各APIリクエストには、リクエストヘッダーに認証情報を含める必要があります。これはAuthorizationヘッダーで提供され、AccessKeyと生成されたEncodeSignで構成されます。
Authorization: <AccessKey>:<EncodeSign>
認証トークン(EncodeSign)の生成方法の詳細については、Authentication documentation.を参照してください。
リクエストボディ
リクエストボディは、処理対象のメディアファイルと実行する処理タイプをメディア処理サービスに指示するために不可欠です。リクエストボディはapplication/x-www-form-urlencoded形式で、以下のパラメータを含める必要があります：
bucket=[Bucket]&key=[Key]&fops=[Fops]¬ifyURL=[NotifyURL]&force=[Force]&separate=[Separate]
各パラメータの詳細説明は以下の表をご覧ください：
| パラメータ | 必須 | 説明 |
|---|---|---|
| bucket | はい | オブジェクトストレージ内の処理対象ファイルを含むバケット名 |
| key | はい | 処理対象ファイルの名前 |
| fops | はい | 動画や音声に対して実行したいメディア処理のタイプを指定します。 具体的な処理タスクに応じてfopsパラメータを構築する必要があります。詳細は以下を参照： Transcoding, Transmuxing, Video Encryption, Intelligent Transcoding ,Editing. |
| notifyURL | いいえ | コールバックアドレス。メディア処理タスクが失敗または完了すると、このアドレスに通知が送信されます。 リクエストボディ内ではURLセーフなBase64エンコードが必要です。 詳細はCallback Notificationを参照 |
| force | いいえ | 既存ファイルの上書き可否： • 0 - ターゲットファイルが既に存在する場合は処理しない• 1 - 強制的に処理して上書きするデフォルト値は0 |
| separate | いいえ | 通知方法： • 0 - すべての処理が完了してからコールバック• 1 - 各処理タスクごとに個別にコールバックデフォルト値は0 |
リクエスト例
curl -v -X POST --url "http://mgrDomain/fops"
-d "bucket=aW1hZ2Vz&key=bGVodS5tcDQ==&fops=YXZ0aHVtYi9mbHYvcy80ODB4Mzg0fHNhdmVhcy9hVzFoWjJWek9tZHFhQzVtYkhZPQ=="
-H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg=="