CMS API 錯誤消息參考

這是對由 CMS API。另見錯誤消息參考 Dynamic Ingest API，與 CMS API 用於攝取視頻。

一般錯誤訊息

狀態	名稱	訊息	導致
400	`BAD_REQUEST`	`ILLEGAL_PATH: A request for more than 10 videos is not supported`	基礎的 `GET /videos/video_ids` 請求不能請求超過10個視頻
400	`INVALID_SORT`	`Attempted to sort by invalid property: '[property name]'`	`sort` 參數指向無效或不存在的字段
400	`INVALID_SEARCH`	`Search string was invalid`	搜索字符串語法無效，或者您無法URI編碼搜索字符串
400	`ILLEGAL_QUERY`	`There was a problem with the query string`	搜索字符串語法無效-示例：1）執行 `tags` 以逗號結尾或引號未結束的搜索
400	`BAD_VALUE`	`Unrecognized field in the submitted data`	拼寫錯誤或不存在字段的其他用途
400	`AD_CONFIG_NOT_FOUND`	`Ad config not found`	找不到SSAI請求中指定的廣告配置
400	`AD_CONFIG_INACTIVE`	`Ad config is inactive`	SSAI請求中指定的廣告配置無效
400	`REFERENCES_EXIST`	`This video is referenced by at least one playlist.`	您正在嘗試刪除至少一個播放列表中包含的視頻。
400	`SHARED_VIDEO`	`Delete of shared video failed.`	尚不支持刪除共享視頻。
401	`UNAUTHORIZED`	`Permission denied.`	OAuth訪問令牌缺失或無效。如果您確實提供了訪問令牌，則該令牌可能沒有此請求的適當範圍
403	`NOT_AVAILABLE`	`Resource is not available.`	您請求的資源暫時不可用-在進行某種形式的視頻處理時，這可能是暫時的情況，但是如果消息仍然存在，請聯繫支持部門。
404	`NOT_FOUND`	`Resource does not exist.`	您請求的資源不存在-請檢查拼寫。
405	`METHOD_NOT_ALLOWED`	`The HTTP method used for the request is not allowed for this resource`	最常見的原因是將PUT，POST，PATCH或DELETE發送到只讀資源。
406	`NOT_ACCEPTABLE`	`The HTTP Accept header has a value not allowed.`	`Accept` 標頭必須具有值 `application/json`; 其他值，例如 `application/x-www-form-urlencoded` 將導致該請求被拒絕並出現此錯誤。
409	`LIVE_VIDEOS_NOT_SHAREABLE`	`This video cannot be shared because it is live.`	Live 流媒體視頻和從中創建的剪輯無法共享。
409	`REFERENCE_ID_IN_USE`	`Reference id is already in use.`	您試圖使用參考ID創建已經使用的視頻，或者將參考ID添加到另一個視頻已經使用的視頻。
409	`CONCURRENT_UPDATE`	`Update failed because of another update at the same time. Please try again.`	當前有單獨的API請求，Studio用戶或某些系統進程正在更新視頻。如果您要快速連續異步對同一視頻發出API更新請求，也會發生這種情況。
409	`CONFLICT`	`Reference id is already in use.`	為了確保參考ID的唯一性，涉及參考ID的操作最多會將ID鎖定3分鐘。這意味著，如果您發出創建或更改參考ID的請求，然後立即發出使用該參考ID的任何其他請求，則該操作將失敗，並顯示409錯誤。這將包括：1）刪除視頻，然後嘗試將其參考ID分配給另一個視頻； 2）嘗試創建失敗並出現503（服務不可用）錯誤的新視頻，然後再次嘗試相同的請求。收到此錯誤後，請至少等待3分鐘，然後重試該操作。另請注意，如果您嘗試使用參考ID創建視頻，但嘗試失敗（由於與參考ID無關的原因），該參考ID將被鎖定30秒鐘，並且重複創建視頻的嘗試將失敗，直到您等待足夠長的時間以使參考ID解鎖。
409	`CONFLICT`	`Both accounts must be enabled for media sharing.`	當主帳戶嘗試將會員帳戶添加到用於媒體共享的頻道時，都必須啟用帳戶才能進行媒體共享。
409	`UNSUPPORTED_MEDIA_TYPE`		該請求很可能缺少標題： `Content-Type: application/json`.
415	`SHARING_DISABLED`	`Master account is not enabled for media sharing.`	如果您嘗試從未啟用媒體共享的帳戶共享視頻，則會返回此錯誤。
422	`ILLEGAL_FIELD`	`Unrecognized field in the submitted data`	拼寫錯誤或不存在字段的其他用途
422	`VALIDATION_ERROR`	（JSON數據無效-錯誤消息因問題而異）	消息示例：名稱：REQUIRED_FIELD（創建一個沒有視頻名稱的視頻，將名稱更新為空字符串） account_id：WRONG_ACCOUNT（URL中的帳戶ID與JSON中的帳戶ID不匹配）無效的鍵：ID（ID不能修改，並且不應在JSON中顯示為鍵）
429	`TOO_MANY_REQUESTS`	`Too many requests`	您同時提交太多請求或每秒提交太多請求
500	`UNKNOWN`	`an unknown internal error occurred`	Brightcove系統中的問題-稍後再試。
503	`SERVICE_UNAVAILABLE`	`The API is temporarily unavailable`	後端問題-請稍後再試。
504	`TIMEOUT`	`something took too long`	服務器可能太忙-請稍後再試。

媒體共享錯誤

媒體共享錯誤不會作為對API請求的單獨錯誤響應返回，而是在 error_message 正常響應中的字段：

  [
  {
  "video_id" : "394872349182374",
  "affiliate_id" : "234987239487",
  "affiliate_video_id" : "30308254055202",
  "status" : "COMPLETE",
  "shared_at" : "2017-12-11T17:57:45.530Z",
  "updated_at" : "2017-12-11T18:03:32.789Z",
  "error_message" : "[{"error_code":"MISSING_CUSTOM_FIELDS","error_message":"Affiliate account is missing custom fields: [whisky]"}]"
  }
  ]

error_message json將是錯誤對象的數組，對象將具有 error_code 和 error_message.

`error_code`

錯誤代碼通常是特定於共享的，但也可以是視頻上的PATCH（更新）操作也可以返回的任何有效錯誤代碼。共享特定的錯誤代碼如下表所示。

媒體共享錯誤代碼
`error_code`	`error_message`	導致
`MISSING_CUSTOM_FIELDS`	`Affiliate account is missing custom fields: [field1, field2]}`	主人已經定了 `enforce_custom_fields` 至 `true`，但正在共享的視頻引用了會員帳戶中不存在的字段。
`CONFLICT`	`Affiliate account is not configured for geo restriction.`	主服務器將forcer_geo設置為true，並且其帳戶配置為進行地理過濾，但未將關聯帳戶配置為進行地理過濾。
`SHARING_DISABLED`	`Affiliate account is not enabled for media sharing.`	主機嘗試與未啟用媒體共享的會員共享視頻。
`NOT_FOUND`	`Resource does not exist.`	缺少了一些東西。通常，這意味著主視頻不見了。如果共享請求後緊接著刪除主視頻，則會發生這種情況。這也可能意味著主帳戶尚無頻道，或者會員帳戶不存在或不是該頻道的有效成員。如果遷移到時出現問題，則可能會發生這種情況 CMS API 媒體共享。
`UNKNOWN`	`Sharing failed with an unknown error, error_id INSERT-UNIQUE-ERROR-ID`	發生了意外情況。 error_message將包含一個錯誤ID，devops可以使用該錯誤ID來識別根本原因。重試共享嘗試將在許多情況下起作用。
`VALIDATION_ERROR`	`{field}: ILLEGAL_VALUE`	如果{field}為“經濟”，則問題在於主視頻為“ AD SUPPORTED”，但會員帳戶未啟用廣告。如果在禁用廣告帳戶的情況下將廣告設置為（非共享視頻的）視頻元數據上支持的廣告，也會發生這種情況。如果{field}是其他內容，則需要進行調查。
`REFERENCE_ID_IN_USE`	`Reference id whatever-you-used is already in use.`	參考ID在主帳戶中有效，但會員帳戶已在使用它。