本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

从 Grafana 版本 12 开始，Grafana HTTP API 正在过渡到版本一致的新标准化 API 结构。新 API 遵循路 Kubernetes-style 径格式：

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

其中：
+ **group**-将相关功能组织到逻辑集合中。例如，`playlist.grafana.app`用于播放列表操作。
+ versi@@ **on** — 使用具有稳定性级别的语义版本控制：`v1alpha1`（实验性）、`v1beta1`（预发布）和`v1`（GA，稳定且具有向后兼容性保证）。
+ **资源**-资源类型，例如`playlists`或`dashboards`。
+ **name**-特定资源实例的唯一标识符。用于获取、更新和删除操作。

API 响应遵循带有`kind`、`apiVersion``metadata`、和`spec`字段的标准化格式。

有关新 API 结构的更多信息，请参阅 *Grafana* Labs 文档中的[新 API 结构](https://grafana.com/docs/grafana/latest/developer-resources/api-reference/http-api/apis/)。