Aide - liste de domaines

# Accéder à sa liste de domaines en tant que service

> Note : l'aide correspondant à l'API de tests est [disponible ici](./help-test.html).

## Clé d'API

L'accès à la liste de domaines se fait via une clé d'API. Si une clé ne vous a pas été fournie, veuillez nous contacter pour la récupérer.

**Cette clé doit rester secrète**.

## Requête

Vous pouvez accéder à votre liste de domaines via une requête GET sur l'url suivante :

```
https://domaines-lasuite.numerique.gouv.fr/v1/domains
```

La clé d'API doit être passée dans le header `Authorization` suivant ce format : `Bearer XXXXX`.

### Exemple

Exemple de requête via curl, en supposant que la clé d'API est `15f6b6a74c00057ea5c879c23271697224156d521193d7e1c7f005bec48e518e`  :

```
curl 'https://domaines-lasuite.numerique.gouv.fr/v1/domains' \
  -X GET \
  -H "Authorization: Bearer 15f6b6a74c00057ea5c879c23271697224156d521193d7e1c7f005bec48e518e" \
```

## Réponse

L'API renvoie la liste des domaines autorisés dans un format JSON suivant le même format que cet exemple :

```
{
    "status": "success",
    "items": [
        "gouv.fr",
        "service-public.fr",
        "gouvernement.fr"
    ],
    "count": 3
}
```