Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# API d'URL courte
<a name="v12-Grafana-API-ShortURL"></a>

Utilisez l'API Short URL pour créer des URL raccourcies. Une URL courte représente une URL plus longue contenant des paramètres de requête complexes dans un format plus petit et plus simple.

**Note**  
Pour utiliser une API Grafana avec votre espace de travail Amazon Managed Grafana, vous devez disposer d'un jeton de compte de service valide. Vous l'incluez dans le `Authorization` champ de la demande d'API.

## Création d'une URL courte
<a name="v12-Grafana-API-ShortURL-create"></a>

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

Crée une URL courte.

**Exemple de demande**

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

Schéma de corps JSON :
+ **path** — Le chemin à raccourcir, par rapport à l'URL racine de Grafana.

**Exemple de réponse**

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

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

Codes de statut :
+ **200** — Créé
+ **400** — Erreurs (JSON non valide, champs manquants ou non valides)

## Obtenir une URL courte
<a name="v12-Grafana-API-ShortURL-get"></a>

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

Récupère une URL courte par son UID.

**Exemple de demande**

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

**Exemple de réponse**

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

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