Sawtooth Lake学习笔记（十）

五、 REST API

Sawtooth提供了REST API（请参阅REST API参考），它允许客户端通过常用的HTTP / JSON标准来进行与验证组件的交互。它是一个实用的RESTful API，提供了与多种编程语言友好的接口来提交交易和读取区块。

Sawtooth REST API仅作为一个供客户端使用的简单接口。验证组件和交易处理器则使用一个ZMQ / Protobuf接口，该接口更有效和健壮，同时也更复杂一些。请注意，客户端也可以选择使用ZMQ / Protobuf接口与验证组件进行通信。

REST API是基于Sawtooth内部ZMQ通信之上的一个轻量级应用。所以，API不提供任何授权。它只是将每个请求传递给验证组件，通过签名验证或交易处理器定义的其他策略来进行授权。

REST API流程作为一个独立的流程运行，而不是作为验证组件流程中的一部分来运行。它将验证组件视为黑匣子，它只管发送交易并获取结果而已。

1. 响应包

REST API使用JSON包将元数据以易于解析和易于自定义的方式回复客户端。所有成功的请求都以封包形式返回数据，该封包可能包括所请求的资源，链头ID，所请求资源的链接以及寻呼信息（如下所述）。

JSON响应封包还包含解析错误所需的详细信息。有关更多信息，请参见错误响应。

2. 分页

API端点包含了客户端可能感兴趣的REST形式的Sawtooth账本中信息的引用，例如区块和交易，以及REST形式的元数据（例如批次状态）。

返回资源列表的所有端点将自动对结果进行分页，默认每页最多100个资源。