# API 版本与兼容性

> 原文地址: https://docs.blockvectra.com/zh/api/versioning/

## 版本方式

BlockVectra API 采用路径版本 `/v1`。

## 兼容的变更

以下变更属于兼容变更，不升版本，客户端必须忽略未知字段：

* 新增字段
* 新增 `error.data.reason` 取值
* 新增端点
* 新增可选参数

客户端遇到不认识的 reason，按同一错误对象里的 `retryable` 处理。详见[错误参考页](https://docs.blockvectra.com/zh/errors/)。

## 不兼容的变更

只有以下不兼容变更才会升 `/v2`：

* 删除字段
* 改变字段含义
* 改变返回粒度

## 不属于接口版本变化

链和方法的上下线由 `GET /v1/chains` 实时反映，属于运营配置，不算接口版本变化。

## 价格与 CU 权重

价格表实时来自 `GET /v1/plans` 的 `method_weights`，与计费使用同一份。最新价格与计费规则见[定价页](https://blockvectra.com/zh/pricing/)。

## 给 Agent 与 SDK 作者的建议

由上述规则直接推出的建议：

1. **忽略未知字段**：客户端必须忽略未知字段。
2. **未知 reason 看 `retryable`**：遇到不认识的 reason，按同一错误对象里的 `retryable` 处理。