codecamp

错误对象中的保留属性名

JSON对象的_error_属性应包含以下属性。

error.code

属性值类型: 整数(integer)
父节点: error

表示该错误的编号。这个属性通常表示HTTP响应码。如果存在多个错误,_code_应为第一个出错的错误码。

示例:

{
  "error":{
    "code": 404
  }
}

error.message

属性值类型: 字符串(string)
父节点: error

一个人类可读的信息,提供有关错误的详细信息。如果存在多个错误,_message_应为第一个错误的错误信息。

示例:

{
  "error":{
    "message": "File Not Found"
  }
}   

error.errors

属性值类型: 数组(array)
父节点: error

包含关于错误的附加信息。如果服务返回多个错误。_errors_数组中的每个元素表示一个不同的错误。

示例:

{ "error": { "errors": [] } }   

error.errors[].domain

属性值类型: 字符串(string)
父节点: error.errors

服务抛出该错误的唯一识别符。它帮助区分服务的从普通协议错误(如,找不到文件)中区分出具体错误(例如,给日历插入事件的错误)。

示例:

{
  "error":{
    "errors": [{"domain": "Calendar"}]
  }
}

error.errors[].reason

属性值类型: 字符串(string)
父节点: error.errors

该错误的唯一识别符。不同于_error.code_属性,它不是HTTP响应码。

示例:

{
  "error":{
    "errors": [{"reason": "ResourceNotFoundException"}]
  }
}

error.errors[].message

属性值类型: 字符串(string)
父节点: error.errors

一个人类可读的信息,提供有关错误的更多细节。如果只有一个错误,该字段应该与_error.message_匹配。

示例:

{
  "error":{
    "code": 404
    "message": "File Not Found",
    "errors": [{"message": "File Not Found"}]
  }
}       

error.errors[].location

属性值类型: 字符串(string)
父节点: error.errors

错误发生的位置(根据_locationType_字段解释该值)。

示例:

{
  "error":{
    "errors": [{"location": ""}]
  }
}

error.errors[].locationType

属性值类型: 字符串(string)
父节点: error.errors

标明如何解释_location_属性。

示例:

{
  "error":{
    "errors": [{"locationType": ""}]
  }
}

error.errors[].extendedHelp

属性值类型: 字符串(string)
父节点: error.errors

help text的URI,使错误更易于理解。

示例:(注:原示例这里有笔误,中文版这里做了校正)

{
  "error":{
    "errors": [{"extendedHelp": "http://url.to.more.details.example.com/"}]
  }
}

error.errors[].sendReport

属性值类型: 字符串(string)
父节点: error.errors

report form的URI,服务用它来收集错误状态的数据。该URL会预先载入描述请求的参数

示例:

{
  "error":{
    "errors": [{"sendReport": "http://report.example.com/"}]
  }
}
用于链接的保留属性名
属性顺序
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }