Darcy Liu · 更新于 2018-11-20 08:00:36

JSON 风格指南

该风格指南是对在Google创建JSON APIs而提供的指导性准则和建议。总体来讲,JSON APIs应遵循JSON.org上的规范。这份风格指南澄清和标准化了特定情况,从而使Google的JSON APIs有一种标准的外观和感觉。这些指南适用于基于RPC和基于REST风格的API的JSON请求和响应。

定义

为了更好地实现这份风格指南的目的,下面几项需要说明:

  • 属性(property) - JSON对象内的键值对(name/value pair)
  • 属性名(property name) - 属性的名称(或键)
  • 属性值(property value) - 分配给属性的值

示例:

{
  // 一组键值对称作一个 "属性".
  "propertyName": "propertyValue"
}

Javascript的数字(number)包含所有的浮点数,这是一个宽泛的指定。在这份指南中,数字(number)指代Javascript中的数字(number)类型,而整型(integer)则指代整型。

致谢
内容撰写:https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md

英文版:http://google-styleguide.googlecode.com/svn/trunk/jsoncstyleguide.xml

更新日期 更新内容
2015-05-26 JSON 风格指南
下一篇: 一般准则