CMS 應用程式介面錯誤訊息參考

這是 CMS API 傳回的錯誤訊息的參考。另見動態提取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	`RESOURCE_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.	無法共享實時流式視頻和由它們創建的剪輯。
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（創建一個沒有視頻名稱的視頻，將名稱更新為空字符串）帳戶ID：WRONG_ACCOUNT （URL中的帳戶ID與JSON中的帳戶ID不匹配）無效的鍵：ID（ID不能修改，並且不應在JSON中顯示為鍵）
429	`TOO_MANY_REQUESTS`	Too many requests	您正在同時提交太多請求或每秒提交太多請求
500	`UNKNOWN`	an unknown internal error occurred	布萊特灣系統中的問題-稍後再試。
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.	主服務器將forced_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在主帳戶中有效，但聯屬會員帳戶已在使用它。