5. 响应对象
最后更新于:2022-04-01 01:20:07
当发起一个rpc调用时,除通知之外,服务端都必须回复响应。响应表示为一个JSON对象,使用以下成员:
**jsonrpc**
> 指定JSON-RPC协议版本的字符串,必须准确写为“2.0”
**result**
> 该成员在成功时必须包含。
>
> 当调用方法引起错误时必须不包含该成员。
>
> 服务端中的被调用方法决定了该成员的值。
**error**
> 该成员在失败是必须包含。
>
> 当没有引起错误的时必须不包含该成员。
>
> 该成员参数值必须为5.1中定义的对象。
**id**
> 该成员必须包含。
>
> 该成员值必须于请求对象中的id成员值一致。
>
> 若在检查请求对象id时错误(例如参数错误或无效请求),则该值必须为空值。
响应对象必须包含result或error成员,但两个成员必须不能同时包含。
## 5.1 错误对象
当一个rpc调用遇到错误时,返回的响应对象必须包含错误成员参数,并且为带有下列成员参数的对象:
**code**
> 使用数值表示该异常的错误类型。 必须为整数。
**message**
> 对该错误的简单描述字符串。 该描述应尽量限定在简短的一句话。
**data**
> 包含关于错误附加信息的基本类型或结构化类型。该成员可忽略。 该成员值由服务端定义(例如详细的错误信息,嵌套的错误等)。
-32768至-32000为保留的预定义错误代码。在该范围内的错误代码不能被明确定义,保留下列以供将来使用。错误代码基本与XML-RPC建议的一样,url: [http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php](http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php)
| code | message | meaning |
| --- | --- | --- |
| -32700 | Parse error语法解析错误 | 服务端接收到无效的json。该错误发送于服务器尝试解析json文本 |
| -32600 | Invalid Request无效请求 | 发送的json不是一个有效的请求对象。 |
| -32601 | Method not found找不到方法 | 该方法不存在或无效 |
| -32602 | Invalid params无效的参数 | 无效的方法参数。 |
| -32603 | Internal error内部错误 | JSON-RPC内部错误。 |
| -32000 to -32099 | Server error服务端错误 | 预留用于自定义的服务器错误。 |
除此之外剩余的错误类型代码可供应用程序作为自定义错误。