Response_Media Processing_Media Acceleration VoD-CDNetworks ドキュメント

このドキュメントではAPIリクエストのレスポンスフォーマットと返却される可能性のあるHTTPレスポンスコードについて説明します。

レスポンスフォーマット

リクエストが成功した場合、サービスはpersistentIdを含むJSONレスポンスを返します:

{
    "persistentId": "<persistentId>"
}

persistentIdはタスクを追跡するための一意の識別子です。トラブルシューティングの際にサポートへ問い合わせる際、このIDをご提示ください。

重要: persistentIdはリクエストの正常な受付を確認するものであり、メディア処理タスクの完了を保証するものではありません。タスク状態を監視するため、コールバック設定によるステータス通知の受信を推奨します。

リクエストが失敗した場合、サービスはエラー詳細を含むJSONレスポンスを返します:

{
    "code": "<HTTP_RESPONSE_CODE>",
    "message": "<ERROR_MESSAGE>"
}

フィールド	説明
`code`	HTTPレスポンスコード（下記HTTPステータスコード参照）
`message`	メディア処理失敗理由を説明するメッセージ

コード	レスポンスメッセージ	説明
200	OK	操作が正常に完了しました
304	Not Modified	ファイルは最新版のため変更されていません
401	Authorization Required	リクエストにAuthorizationヘッダーが必要です
401	AK/SK Not Found	AccessKey（AK）またはAccessKey Secret（SK）が見つかりません
401	Token Invalid	リクエストトークンが不正です
401	ExpireTime Is Null	ExpireTimeフィールドが空です
401	Token Format Invalid	リクエストトークンのフォーマットが不正です
401	Bucket Access Denied	リクエストされたBucketへのアクセスが拒否されました
401	The Persistent File Already Exists	永続化ファイルは既に存在します
404	Bucket Not Found	リクエストされたBucketが存在しません
404	File Not Found	リクエストされたファイルが見つかりません
404	bucketErrorPage	リクエストされたリソースが存在しません
404	Bucket Not Binding Mirror	リクエストされたBucketにミラーソースがバインドされていません
405	Token Required	リクエストにTokenパラメータが必要です
406	File Already Exist	ファイルは既に存在します
406	File Is Busy, Please Retry Later	ファイル処理中です。後ほど再試行してください
500	Internal Server Error	サーバー内部エラーが発生しました

コード	レスポンスメッセージ	説明
401	Bucket Open Image Protect Function, Unable To Get Original Image	オリジナル画像保護機能が有効なため原図へのアクセスが禁止されています
401	Non-standard Type Of Op	非標準の操作タイプです
401	Image Process Param Error	画像処理パラメータエラー
404	Watermark Image Url Invalid	ウォーターマーク画像URLが無効です
404	WaterMark Image Not Found	ウォーターマーク画像が見つかりません
579	Get WaterMark Image Fail	ウォーターマーク画像のダウンロードに失敗しました

コード	レスポンスメッセージ	説明
400	Tranfer Parameters Error	トランスコードパラメータエラー
401	Ops Invalid	リクエスト内のfopsパラメータが無効です
404	Video Persistent Progress Info Not Found	ファイル処理タスク情報が見つかりません
579	Json Response	コールバック先ビジネスサーバーのレスポンスに異常が発生しました