json-rpc_2.0 规范
最后更新于:2022-04-02 03:09:25
[TOC]
> [规范](https://wiki.geekdream.com/Specification/json-rpc_2.0.html)
## 概述
SON-RPC是一个无状态且轻量级的远程过程调用(RPC)协议。 本规范主要定义了一些数据结构及其相关的处理规则。它允许运行在基于socket,http等诸多不同消息传输环境的同一进程中。其使用[JSON](http://www.json.org/)([RFC 4627](http://www.ietf.org/rfc/rfc4627.txt))作为数据格式。
## 请求对象
**jsonrpc**
> 指定JSON-RPC协议版本的字符串,必须准确写为“2.0”
**method**
> 包含所要调用方法名称的字符串,以rpc开头的方法名,用英文句号(U+002E or ASCII 46)连接的为预留给rpc内部的方法名及扩展名,且不能在其他地方使用。
**params**
> 调用方法所需要的结构化参数值,该成员参数可以被省略。
**id**
> 已建立客户端的唯一标识id,值必须包含一个字符串、数值或NULL空值。如果不包含该成员则被认定为是一个通知。该值一般不为NULL[\[1\]](https://wiki.geekdream.com/Specification/json-rpc_2.0.html#id1),若为数值则不应该包含小数[\[2\]](https://wiki.geekdream.com/Specification/json-rpc_2.0.html#id2)。
## 响应对象
**jsonrpc**
> 指定JSON-RPC协议版本的字符串,必须准确写为“2.0”
**result**
> 该成员在成功时必须包含。
>
> 当调用方法引起错误时必须不包含该成员。
>
> 服务端中的被调用方法决定了该成员的值。
**error**
> 该成员在失败是必须包含。
>
> 当没有引起错误的时必须不包含该成员。
>
> 该成员参数值必须为5.1中定义的对象。
**id**
> 该成员必须包含。
>
> 该成员值必须于请求对象中的id成员值一致。
>
> 若在检查请求对象id时错误(例如参数错误或无效请求),则该值必须为空值。
响应对象必须包含result或error成员,但两个成员必须不能同时包含。
## 错误对象
**code**
> 使用数值表示该异常的错误类型。 必须为整数。
**message**
> 对该错误的简单描述字符串。 该描述应尽量限定在简短的一句话。
**data**
> 包含关于错误附加信息的基本类型或结构化类型。该成员可忽略。 该成员值由服务端定义(例如详细的错误信息,嵌套的错误等)。
\-32768至-32000为保留的预定义错误代码。
';