# API 版本控制與相容性

> Source: https://docs.blockvectra.com/zh-hant/api/versioning/

## 版本機制

BlockVectra API 採用路徑版本控制：`/v1`。

## 相容變更

以下變更屬於回溯相容變更；用戶端必須忽略未知欄位：

* 新增欄位
* 新增 `error.data.reason` 值
* 新增端點
* 新增選填參數

當遇到無法識別的 reason 時，用戶端必須根據同一錯誤物件中的 `retryable` 欄位進行處理。請參閱[錯誤參考](https://docs.blockvectra.com/zh-hant/errors/)。

## API 版本控制以外的變更

鏈與方法隨時可能新增或移除；請在執行時讀取 `GET /v1/chains`。

## 定價與 CU 權重

價格表即時取自 `GET /v1/plans`（`method_weights`）。請參閱[定價頁面](https://blockvectra.com/zh-hant/pricing/)。