REST API with Accept Header application/json returns 一个数字
REST API with Accept Header application/json returns a number
新手问题:
我在申请中休息 api:https://hostname/app-rest/session/manager/active-session/count
。 API return 具有特定属性(如连接类型、状态等)的会话数。
当我设置请求 header Content-Type: application/json
时,响应 header Accept: application/json
并发送带有 body 的请求,例如:
{"loggedIn": "yes", connectionType" : "mobile"}
,我收到数字为 0、1、2 等的响应
问题:基于此:http://json.org/,似乎响应是有效的 JSON 格式。然而,这是好的设计实践吗? return 键值对格式的值是否更可取,这样所有客户端都可以理解和解析响应 - 而不是假设客户端知道 return 编辑的内容API ?
根据 original RFC,数字本身是 不是 有效的 JSON 文本。 JSON 必须始终以 {
或 [
开头(前面可以选择一些空白字符)。
有一个 new RFC 通过允许任何 JSON 值成为完整的 JSON 文本来对此进行修改。如果你按照这个 RFC,那么一个数字本身就是 calid JSON.
目前我建议返回一个对象,其中包含一个描述返回数字含义的键,因为这将符合两个 RFC。
新手问题:
我在申请中休息 api:https://hostname/app-rest/session/manager/active-session/count
。 API return 具有特定属性(如连接类型、状态等)的会话数。
当我设置请求 header Content-Type: application/json
时,响应 header Accept: application/json
并发送带有 body 的请求,例如:
{"loggedIn": "yes", connectionType" : "mobile"}
,我收到数字为 0、1、2 等的响应
问题:基于此:http://json.org/,似乎响应是有效的 JSON 格式。然而,这是好的设计实践吗? return 键值对格式的值是否更可取,这样所有客户端都可以理解和解析响应 - 而不是假设客户端知道 return 编辑的内容API ?
根据 original RFC,数字本身是 不是 有效的 JSON 文本。 JSON 必须始终以 {
或 [
开头(前面可以选择一些空白字符)。
有一个 new RFC 通过允许任何 JSON 值成为完整的 JSON 文本来对此进行修改。如果你按照这个 RFC,那么一个数字本身就是 calid JSON.
目前我建议返回一个对象,其中包含一个描述返回数字含义的键,因为这将符合两个 RFC。