

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Utilice la API de URL cortas para crear URL abreviadas. Una URL corta representa una URL más larga que contiene parámetros de consulta complejos en un formato más pequeño y sencillo.

**nota**  
Para usar una API de Grafana con tu espacio de trabajo de Grafana gestionado por Amazon, debes tener un token de cuenta de servicio válido. Lo incluye en el campo `Authorization` de la solicitud de API.

## Crea una URL corta
<a name="v12-Grafana-API-ShortURL-create"></a>

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

Crea una URL corta.

**Ejemplo de solicitud**

```
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 de cuerpo JSON:
+ **ruta**: la ruta que se va a acortar, en relación con la URL raíz de Grafana.

**Ejemplo de respuesta**

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

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

Códigos de estado:
+ **200** — Creado
+ **400** — Errores (JSON no válido, campos faltantes o no válidos)

## Obtenga una URL corta
<a name="v12-Grafana-API-ShortURL-get"></a>

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

Recupera una URL corta por su UID.

**Ejemplo de solicitud**

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

**Ejemplo de respuesta**

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

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