Clés API
L’API KENN HOSTING utilise des clés API Bearer Token pour l’authentification. Chaque requête doit inclure votre clé dans l’en-tête HTTPAuthorization.
Générer une clé API
1
Accéder aux paramètres API
Espace client → Mon compte → API → Mes clés API
2
Créer une nouvelle clé
Cliquez sur Générer une clé API. Donnez-lui un nom descriptif (ex: “Production - Mon app”, “Monitoring”).
3
Définir les permissions
Choisissez les permissions de la clé (principe du moindre privilège recommandé) :
services:read: lire les services (liste et détail)services:renew: initier un renouvellement (POST /v1/services/{uuid}/renew)domains:read: disponibilité (check,check-bulk) et devis (GET /v1/domains/quote)domains:write: créer une commande d’achat domaine seul (POST /v1/domains)domains:pay: initier le paiement d’un domaine (POST /v1/domain-orders/{uuid}/pay)domains:dns: gestion DNS (/v1/domains/{domain}/dns/...)invoices:read: consulter les facturesinvoices:pay: initier un paiement (POST /v1/invoices/{uuid}/pay)reseller:clients/reseller:hosting/reseller:domains/reseller:vps: API revendeurreferral:read/referral:withdraw: parrainagesupport:read/support:write: ticketswebhooks:read/webhooks:write: webhooks sortants
4
Copier la clé
Copiez immédiatement la clé affichée. Elle ne sera plus affichée en clair après cette étape. Si vous la perdez, vous devrez en générer une nouvelle.
Format des clés
Les clés API KENN HOSTING ont le format suivant :Environnement Sandbox
Utilisez les cléskh_test_ pour tester vos intégrations sans affecter vos vrais services ni effectuer de vrais paiements.
URL de base sandbox :
Rotation des clés
Bonne pratique : faites tourner vos clés régulièrement, au minimum tous les 6 mois ou immédiatement en cas de compromission suspectée.- Générez une nouvelle clé avec les mêmes permissions
- Mettez à jour la variable d’environnement dans vos applications
- Vérifiez que les applications fonctionnent avec la nouvelle clé
- Révoquez l’ancienne clé
Révoquer une clé
Mon compte → API → Mes clés API → [clé] → Révoquer La révocation est immédiate. Toute requête utilisant cette clé retournera401 Unauthorized.