【问题标题】:JSON-RPC schema specification?JSON-RPC 模式规范?
【发布时间】:2019-01-12 21:32:54
【问题描述】:

我正在考虑尝试为特定的 json-rpc 2.0 服务实现客户端,该服务可以为用户提供一些静态类型保证。有问题的 API 非常大,所以实际上要手动编写一个功能齐全的客户端,其中包含所有必要的类型信息,这对我来说是一项艰巨的任务。但是,我通过一个未记录的 http 端点发现了一个基于 json 的大型架构,它似乎完全描述了整个 json-rpc 服务。我确信我可以使用这个规范编写某种代码生成器。太大了,这里贴不出来。

我的问题是,是否有描述 json-rpc 服务的标准规范?我进行了搜索,发现很多死链接,而 json-rpc 的官方规范 [1] 没有提及此类服务的标准模式定义。我发现的模式似乎至少部分基于 json-schema 规范[2]。

json-rpc

Json Schema

【问题讨论】:

    标签: json-rpc


    【解决方案1】:

    JSON Schema 非常适合定义有效负载格式(您甚至可以将它用于 OpenAPI 中的 REST API),但它确实无助于描述“RPC”部分以及方法和入口点。

    OpenRPC,创建于early 2019,似乎是最有前途的

    以太坊经典实验室核心 (ECLC) 团队最近创建了 OpenRPC 规范,旨在改进所有区块链 dapp 开发。该规范模拟了 OpenAPI,这是一种成功且被广泛采用的 REST API 规范。

    OpenRPC 规范为 JSON-RPC 2.0 API 定义了与编程语言无关的标准接口描述。

    其他方法

    Drupal JSON-RPC module 提供发现端点和 Postman 集合

    可以通过向 /jsonrpc/methods 发送 HTTP GET 请求来发现可用的 RPC 服务以及文档和使用详情。

    您可以将此Postman Collection 用于示例和测试。

    AsyncAPIgRPCGraphQL 也可能会带来有趣的东西。

    死亡

    还引用了我偶然发现但已死的其他一些选项:

    JSON-WSP 似乎已过时,维基百科页面正在等待删除(讨论页面似乎说这实际上从来都不是标准)

    JSON-WSP(JavaScript Object Notation Web-Service Protocol)是一个 使用 JSON 进行服务描述、请求的 Web 服务协议 和回应。它的灵感来自 JSON-RPC,但缺少服务 带有 JSON-RPC 文档的描述规范引发了 JSON-WSP的设计。

    JSON Schema Service Descriptor 似乎仍然是草稿

    JSON Schema 服务描述符只是一个带有附加方法定义的 JSON Schema。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2011-02-07
      • 2021-12-05
      • 1970-01-01
      • 1970-01-01
      • 2013-08-13
      • 2016-12-14
      • 2010-11-29
      • 1970-01-01
      相关资源
      最近更新 更多