Authentification
Toutes les requêtes à l'API Metaventus sont authentifiées par une clé API secrète
transmise dans l'en-tête HTTP X-API-Key :
X-API-Key: VOTRE_CLE_SECRETE
Nombre de clés selon l'offre
L'offre gratuite Découverte donne droit à une clé API : de quoi brancher une intégration et découvrir l'API. Les offres Professionnel et Entreprise n'ont pas de limite. Pour créer davantage de clés, changez d'offre depuis Facturation → Abonnement.
Types de clés et portées
Les clés se créent dans le Centre d'administration → Clés API de votre espace :
- Clé secrète (
sk_live_…en production,sk_test_…ailleurs) : usage serveur-à-serveur uniquement. C'est elle qui accède à l'API documentée ici. - Clé publique (
pk_live_…/pk_test_…) : destinée aux intégrations côté navigateur (widgets, formulaires publics). Elle n'ouvre pas les endpoints de cette référence. - Chaque clé peut être limitée par portées (scopes), restreinte par adresse IP et dotée d'une date d'expiration ; la rotation se fait sans coupure en créant la nouvelle clé avant de révoquer l'ancienne.
La clé agit dans le périmètre de votre compte : les données créées sont rattachées à votre compte et à l'espace de travail associé à la clé.
Bonnes pratiques
- Ne partagez jamais votre clé et ne l'exposez pas côté client (navigateur).
- Stockez-la dans une variable d'environnement côté serveur.
- Révoquez et régénérez une clé compromise immédiatement.
- Utilisez une clé par environnement (test / production).
attention
Une requête sans en-tête X-API-Key valide renvoie 401 Unauthorized.