As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# API de URL curta
<a name="v12-Grafana-API-ShortURL"></a>

Use a API Short URL para criar URLs encurtados. Um URL curto representa um URL mais longo contendo parâmetros de consulta complexos em um formato menor e mais simples.

**nota**  
Para usar uma API do Grafana com seu espaço de trabalho Amazon Managed Grafana, você deve ter um token de conta de serviço válido. Você inclui isso no campo `Authorization` na solicitação da API.

## Crie um URL curto
<a name="v12-Grafana-API-ShortURL-create"></a>

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

Cria um URL curto.

**Exemplo de solicitação**

```
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"
}
```

Esquema do corpo JSON:
+ **path** — O caminho a ser encurtado, em relação ao URL raiz da Grafana.

**Exemplo de resposta**

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

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

Códigos de status:
+ **200** — Criado
+ **400** — Erros (JSON inválido, campos ausentes ou inválidos)

## Obtenha um URL curto
<a name="v12-Grafana-API-ShortURL-get"></a>

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

Recupera um URL curto por seu UID.

**Exemplo de solicitação**

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

**Exemplo de resposta**

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

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