การจัดการข้อผิดพลาด

ใช้รหัสสถานะ 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
  • code ควรเป็นรหัสใดรหัสหนึ่งต่อไปนี้สําหรับรหัสสถานะ 400:unknownCommand, cameraInExclusiveUse, missingParameter, invalidParameterName หรือ invalidParameterValue
  • message จะกําหนดโดยผู้ผลิตและไม่คาดว่าจะเป็นข้อความที่แปลเป็นภาษาท้องถิ่น