支持 聯繫支持 | 系統狀況 系統狀態

錯誤參考

這是對由 Playback API.

狀態碼和錯誤

狀態 錯誤代碼 產品描述
200 SUCCESS 正常響應已發送。
400 BAD_REQUEST 格式錯誤的請求,即提供了重複的查詢參數
401 INVALID_POLICY_KEY 必須提供帶有合法策略密鑰的BCOV-Policy標頭。
403 ACCESS_DENIED, VIDEO_NOT_PLAYABLE [1], PLAYLIST_NOT_PLAYABLE, JWT_AUTH 提供的策略密鑰不允許該帳戶或視頻,或者請求的資源無效。
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 呼叫後端服務器或它們所依賴的服務器之一超時。

筆記

[1] VIDEO_NOT_PLAYABLE 可以通過單個視頻請求從Roebuck返回。 它指示視頻未通過可播放的檢查(已按計劃進行了已攝錄,活動,檢查)。

錯誤回應

根據API設計標準,錯誤響應(4xx5xx)由一個或多個包含一個 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 表示在評估政策時出現任何意外錯誤(包括獲取受地理位置限制的帳戶的視頻信息)。 可能值得檢查此錯誤的日誌中的異常。


頁面最後更新於12年2020月XNUMX日