# API

#### Générer des clés d'API

Les utilisateurs peuvent générer **jusqu'à 5 clés d'API par compte**

- Se rendre sur **[dns.coconetworks.org](https://dns.coconetworks.org)**
- En haut à droite, dans *Tools*, cliquer sur *API Keys*
- Cliquer *Add new API key*
- Remplir les informations et enregistrer
- La clé s'affiche et **elle ne s'affichera qu'une fois**

#### Exemple : utiliser l'API pour obtenir des certificats SSL avec `acme.sh`

Après avoir installé `acme.sh`, éditer `~/.acme.sh/account.conf` et ajouter ces variables :

```
POWERADMIN_URL='https://dns.coconetworks.org'
POWERADMIN_API_KEY='votre clé d'API générée dans l'étape précédente'
```

Il est ensuite possible, après avoir `cd ~/.acme.sh`, de lancer l'obtention du certificat par API DNS :

```
./acme.sh --issue --dns dns_poweradmin -d example.com
```

CocoNetworks DNS™ prend également en charge les wildcards :

```
./acme.sh --issue --dns dns_poweradmin -d example.com -d *.example.com
```

<p class="callout success">Pour d'autres utilisations de l'API, la documentation est disponible sur [dns.coconetworks.org/api/docs](https://dns.coconetworks.org/api/docs)</p>