版本和变更日志

原文：https://docs.elrond.com/sdk-and-tools/rest-api/versions-and-changelog

## 概述

此页面提供了Elrond代理 API 重要版本的高级概述，以及针对 API 使用者的建议(如升级或过渡建议)。

本节中的文档是初步的，可能会更改。

Elrond代理 HTTP API v1.1.0

这是创世纪号上发布的 API。

这个 API 版本带来了新的特性，比如超块相关的端点，对于监控区块链非常有用。此外，GET transaction端点已经被调整为包括额外的字段——例如，所谓的超级块坐标(包含超级块的随机数和散列)。

这个 API 从未被部署到 gateway.elrond.com 的的Elrond代理的中央实例中。然而，直到 2020 年 11 月，该 API 已经以观察队的形式在内部部署到几个合作伙伴和第三方服务(如交换系统)，通过 Mainnet 安装脚本-版本 e1.0.0 建立。

该版本的 API 需要标签为 e1.1.0 或更高的观察者节点。

API v1.1.0 和 API v1.1.1 之间没有突破性的变化——无论是在请求/响应的结构和格式方面，还是在 URL 的模式方面。然而，就语义而言，以下修复可能会给一些 API 消费者带来重大改变:

GET transaction端点已修复，以报告实际上无效交易的适当状态无效(例如余额不足)。在版本 1.1.0 中，报告的状态不精确:部分执行。

截至 2020 年 11 月，建议新的 API 消费者使用新版 API。

一旦已知所有现有的 API 消费者已经升级到更新的版本，v1.1.0 和 v1.1.1 将被弃用。

这个 API 版本增加了新的端点，比如network/economics或address/shard。此外，vm-values端点的响应已被更改。然而，也许最重要的变化是交易状态的重命名。

这个版本的 API 需要标签为 v1.1.6 或更高的观察者节点。

在 API v1.1.1 和 API v1.1.3 之间，API 消费者会观察到以下突变:

vm-values端点的所有字段已被重命名(改变了大小写等)。
交易状态的可能值集已更改:已执行已重命名为成功。状态已接收和部分执行已合并到状态待执行下，而状态未执行已更名为未通过。为了让 API 消费者不受这一变化的影响，他们应该遵循查询区块链中的建议。

从 2020 年 11 月起，建议新的 API 消费者转用这个版本(或更新的版本)的 API。提供这个 API 的Elrond代理实例已经在 api-backup.elrond.com 的登台环境 中可用。

对于使用现场观察小组的 API 消费者，将提供一个更新的安装程序(关于这个问题，工作正在进行中)。