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。