本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 新的 API 結構
<a name="v12-Grafana-API-new-structure"></a>

從 Grafana 第 12 版開始，Grafana HTTP APIs轉換至具有一致版本控制的標準化 API 結構。新的 APIs 遵循 Kubernetes 路徑格式：

```
/apis/<group>/<version>/namespaces/default/<resource>[/<name>]
```

其中：
+ **群組** – 將相關功能組織成邏輯集合。例如，`playlist.grafana.app`針對播放清單操作。
+ **版本** – 使用具有穩定性層級的語意版本控制： `v1alpha1`（實驗性）、 `v1beta1` （發行前） 和 `v1`(GA，具有回溯相容性保證）。
+ **resource** – 資源類型，例如 `playlists`或 `dashboards`。
+ **name** – 特定資源執行個體的唯一識別符。用於取得、更新和刪除操作。

API 回應遵循具有 `kind`、`metadata`、 `apiVersion`和 `spec` 欄位的標準化格式。

如需新 API 結構的詳細資訊，請參閱 *Grafana 實驗室文件中*[的新 API 結構](https://grafana.com/docs/grafana/latest/developer-resources/api-reference/http-api/apis/)。