ステータスコードとエラー
| ステータス | エラーコード | 説明 |
|---|---|---|
| 200 | SUCCESS |
通常の応答が送信されます。 |
| 400 | BAD_REQUEST |
誤った形式のリクエスト、つまり重複したクエリパラメータが提供された |
| 401 | INVALID_POLICY_KEY |
BCOV-Policyヘッダーに正当なポリシーキーを提供する必要があります。 |
| 403 | ACCESS_DENIED, VIDEO_NOT_PLAYABLE, PLAYLIST_NOT_PLAYABLE, JWT_AUTH |
提供されたポリシーキーがこのアカウントまたはビデオを許可していないか、要求されたリソースが非アクティブです。VIDEO_NOT_PLAYABLE単一のビデオリクエストでRoebuckから返すことができます。これは、ビデオが再生可能チェックに合格していないことを示します（取り込み、アクティブ、スケジュールどおり）。 |
| 404 | VIDEO_NOT_FOUND, PLAYLIST_NOT_FOUND, RESOURCE_NOT_FOUND, ACCOUNT_NOT_FOUND |
指定されたリソースが見つかりませんでした。 |
| 405 | METHOD_NOT_ALLOWED |
このAPIには、GET、HEAD、およびOPTIONSのみが許可されています。 |
| 500 | SERVER_ERROR |
内部ウェッジサーバーエラー。通常、ログに詳細情報が記録されます。 |
| 502 | SERVER_ERROR, ACCOUNT_RETRIEVE_FAILURE, VIDEO_RETRIEVE_FAILURE, VIDEO_URLS_RETRIEVE_FAILURE, PLAYLIST_RETRIEVE_FAILURE, PLAYLIST_VIDEOS_RETRIEVE_FAILURE |
バックエンドサーバーから不正な応答がありました。通常、RoebuckまたはNomicは5xxエラーを返しました。 |
| 503 | SERVICE_UNAVAILABLE |
ウェッジからは返送されません。ロードバランサーにアクティブなサーバーがない場合に発生する可能性があります。それは悪いことです。（Playerback APIはレート制限を行わず、呼び出すサービスも行いません。） |
| 504 | SERVER_TIMEOUT |
バックエンドサーバーまたはそれらが依存するサーバーの1つへの呼び出しがタイムアウトしました。 |
エラー応答
API設計標準に従って、エラー応答（4xxそして5xx）を含む1つ以上のマップのエラー応答リストで構成されます。error_code、オプションerror_subcode、およびオプションでローカライズされていないmessage詳細については。
[ {"error_code": "ERROR_CODE1"}、{"error_code": "ERROR_CODE2", "message": "details can go here"}{"error_code": "ERROR_CODE3", "error_subcode": "MORE_SPECIFIC_CODE", "message": "human readable details about what happened"} ]
エラーコード
ザ・error_codeこれは、人間が理解できることと、クライアントコードがさまざまなアクションと翻訳可能なユーザーメッセージを選択するために使用することの両方を目的としています。エラーコードはUPPER_SNAKE_CASEです。
| ステータス | エラーコード | エラーソース |
|---|---|---|
| 403 | ACCESS_DENIED |
ノミックポリシー |
| 403 | VIDEO_NOT_PLAYABLE |
ローバック |
| 404 | VIDEO_NOT_FOUND |
ローバック |
| その他 | VIDEO_RETRIEVE_FAILUREビデオを取得できなかった場合 |
ローバック |
| その他 | VIDEO_URLS_RETRIEVE_FAILUREソースや画像を取得できなかった場合 |
ローバック |
エラーサブコード
エラーサブコードのすべてではありませんが、いくつかあります（:error_subcodeソースで）
| エラーコード | エラーサブコード |
|---|---|
BAD_REQUEST |
DUPLICATE_PARAMETERS |
ACCESS_DENIED |
POLICY_ERROR |
ACCESS_DENIED |
ACCOUNT_ID、VIDEO_ID、CLIENT_GEO、CLIENT_IP、DOMAIN、POLICY_ERROR[1] |
SOURCES_RESTRICTED |
TVE_AUTH |
SERVER_ERROR |
LOOKUP_GEO |
SERVER_TIMEOUT |
LOOKUP_GEO |
注
[1] ACCESS_DENIED / POLICY_ERRORポリシーの評価中に予期しないエラーが発生したことを意味します（地理的に制限されたアカウントのビデオ情報の取得を含む）。このエラーのあるログで例外をチェックする価値があるかもしれません。