Compte et API
API et clés
Accéder à votre compte KOVA depuis vos propres outils.
01Créer une clé
Section Clés API du panel. Vous choisissez un nom, une portée et une durée de validité de 1 à 365 jours. Le secret n’est affiché qu’à la création : copiez-le tout de suite.
| Portée | Autorise |
|---|---|
| Lecture seule | Les requêtes GET |
| Lecture et écriture | Toutes les requêtes |
Dix clés actives au maximum par compte. Une clé révoquée cesse immédiatement de fonctionner.
02Authentification
La clé se transmet dans l’en-tête Authorization. Les requêtes doivent être faites en HTTPS.
Exemple
curl https://panel.kovahost.fr/api/panel/capabilities \
-H "Authorization: Bearer kova_VOTRE_CLE"Un jeton commence toujours par kova_. La date de dernière utilisation de chaque clé est enregistrée et visible dans le panel.
03Limites
- Cent vingt requêtes par minute et par compte.
- La création et la révocation de clés ne sont possibles que depuis une session connectée, jamais avec une clé.
- Une clé expirée ou révoquée renvoie une erreur 401.
