錯誤處理

針對此規格中定義的所有錯誤使用 400 Bad Request 狀態碼。 對於所有其他錯誤，製造商應該以 4XX 範圍內的錯誤代表用戶端錯誤，而 5XX 範圍代表伺服器錯誤。 針對所有錯誤案例，回應應該一律使用下列格式包括 JSON 本文：

{
    "name": "camera.info",
    "state": "error",
    "error": {
        "code": "serverError",
        "message": "cannot get camera info."
    }
}

  • name 可以是 camera.info、camera.state、camera.checkForUpdates、camera.commands.status 與 camera.commandName 的其中之一。

  • 對於 400 狀態碼，code 應該為下列其中之一：unknownCommand、cameraInExclusiveUse、missingParameter、invalidParameterName 或 invalidParameterValue。

  • message 是由製造商定義且預期不會是當地語系化訊息。