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

# 短网址 API
<a name="v12-Grafana-API-ShortURL"></a>

使用短网址 API 创建缩短的网址。短 URL 表示较长的 URL，其中包含格式更小、更简单的复杂查询参数。

**注意**  
要在您的亚马逊托管 Grafana 工作空间中使用 Grafana API，您必须拥有有效的服务账户令牌。您可以将其包含在 API 请求的 `Authorization` 字段中。

## 创建短网址
<a name="v12-Grafana-API-ShortURL-create"></a>

```
POST /api/short-urls
```

创建一个简短的网址。

**示例请求**

```
POST /api/short-urls HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "path": "d/TxKARsmGz/new-dashboard?orgId=1&from=1599389322894&to=1599410922894"
}
```

JSON 正文架构：
+ **路径** — 相对于 Grafana 根网址的缩短路径。

**响应示例**

```
HTTP/1.1 200
Content-Type: application/json

{
  "uid": "AT76wBvGk",
  "url": "/goto/AT76wBvGk?orgId=1"
}
```

状态码：
+ **200** — 已创建
+ **400**-错误（JSON 无效、字段缺失或无效）

## 获取简短网址
<a name="v12-Grafana-API-ShortURL-get"></a>

```
GET /api/short-urls/:uid
```

按其 UID 检索短网址。

**示例请求**

```
GET /api/short-urls/AT76wBvGk HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**响应示例**

```
HTTP/1.1 200
Content-Type: application/json

{
  "uid": "AT76wBvGk",
  "path": "d/TxKARsmGz/new-dashboard?orgId=1&from=1599389322894&to=1599410922894"
}
```