基本请求结构
{
"jsonrpc": "2.0",
"method": "subtract",
"params": [42, 23],
"id": 1
}123456
jsonrpc 为固定参数
method 需要调用的方法
params 方法值，非必须
id 可以是数值或字符串，与响应相对应
基本响应结构
{
"jsonrpc": "2.0",
"result": 19,
"id": 1
}12345
通知类型响应为空
批量调用请求结构
[
{"jsonrpc": "2.0", "method": "sum", "params": [1,2,4], "id": "1"},
{"jsonrpc": "2.0", "method": "notify_hello", "params": [7]},
{"jsonrpc": "2.0", "method": "subtract", "params": [42,23], "id": "2"},
{"foo": "boo"},
{"jsonrpc": "2.0", "method": "foo.get", "params": {"name": "myself"}, "id": "5"},
{"jsonrpc": "2.0", "method": "get_data", "id": "9"}
]12345678
响应结构
[
{"jsonrpc": "2.0", "result": 7, "id": "1"},
{"jsonrpc": "2.0", "result": 19, "id": "2"},
{"jsonrpc": "2.0", "error": {"code": -32600, "message": "Invalid Request"}, "id": null},
{"jsonrpc": "2.0", "error": {"code": -32601, "message": "Method not found"}, "id": "5"},
{"jsonrpc": "2.0", "result": ["hello", 5], "id": "9"}
]1234567
根据 id 确定响应的值
响应错误
| code | message | meaning |
|---|---|---|
| -32700 | Parse error | Invalid JSON was received by the server.An error occurred on the server while parsing the JSON text. |
| -32600 | Invalid Request | The JSON sent is not a valid Request object. |
| -32601 | Method not found | The method does not exist / is not available. |
| -32602 | Invalid params | Invalid method parameter(s). |
| -32603 | Internal error | Internal JSON-RPC error. |
| -32000 to -32099 | Server error | Reserved for implementation-defined server-errors. |
JSON-RPC 与 RESTFUL 比较
json rpc 适用与服务器内部通信，例如分布式架构
restful 适用于对外通信，例如与浏览器，APP 等
参考
转载请保留原文链接： https://zodream.cn/blog/id/32.html