錯誤參考

這是對播放 API 傳回的錯誤的參考。

狀態碼和錯誤

狀態 錯誤代碼 描述
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 內部Wedge服務器錯誤，通常在日誌中會有更多信息。
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 呼叫後端服務器或它們所依賴的服務器之一超時。

錯誤回應

根據 API 設計標準，錯誤響應（4xx和5xx ) 由一個或多個地圖的錯誤響應列表組成，其中包括error_code , 一個可選的error_subcode，以及可選的非本地化message有更多細節。

[{“錯誤代碼”：“ ERROR_CODE1”}，
  {"錯誤代碼」:“ ERROR_CODE2”，“消息”：“細節可以在這裡”}
  {"錯誤代碼」:“ ERROR_CODE3”，“ error_subcode”：“ MORE_SPECIFIC_CODE”，“消息”：“關於發生了什麼的可讀信息”}]

錯誤碼

這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指評估政策時出現的任何意外錯誤（包括獲取地理限制帳戶的視頻信息）。可能值得檢查日誌中出現此錯誤的異常。