Authentification
Apprenez à authentifier vos requêtes API avec vos clés API.
Clé API (API Key)
L'API utilise une authentification par clé API. Vous devez inclure votre clé dans le header X-API-Key de chaque requête.
| Header | Format | Description |
|---|---|---|
X-API-Key | pk_live_... | Clé publique requis |
X-API-Secret | sk_live_... | Clé secrète optionnel |
Exemple d'authentification
cURL avec authentification
curl -X GET "https://companybelgium.be/api/companies/search?name=Proximus" \ -H "X-API-Key: pk_live_votre_cle_publique" \ -H "X-API-Secret: sk_live_votre_cle_secrete"
JavaScript
// JavaScript / Node.js
const response = await fetch(
'https://companybelgium.be/api/companies/search?name=Proximus',
{
headers: {
'X-API-Key': 'pk_live_votre_cle_publique',
'X-API-Secret': 'sk_live_votre_cle_secrete',
},
}
);
const data = await response.json();Python
# Python
import requests
response = requests.get(
'https://companybelgium.be/api/companies/search',
params={'name': 'Proximus'},
headers={
'X-API-Key': 'pk_live_votre_cle_publique',
'X-API-Secret': 'sk_live_votre_cle_secrete',
}
)
data = response.json()Obtenir vos clés API
- 1Créez un compte sur companybelgium.be
- 2Accédez à votre tableau de bord et créez une entreprise
- 3Générez une paire de clés API dans la section "Mes clés API"
- 4Copiez votre API Key et API Secret — le secret n'est affiché qu'une seule fois
Erreur d'authentification
Si la clé API est manquante ou invalide, l'API retourne une erreur 401 :
401 Unauthorized
{
"success": false,
"error": "Invalid or missing API key",
"timestamp": "2026-02-08T12:00:00.000Z"
}Bonnes pratiques de sécurité
- Ne partagez jamais vos clés API dans du code public (GitHub, etc.)
- Utilisez des variables d'environnement pour stocker vos clés
- Effectuez les appels API côté serveur, jamais côté client
- Désactivez ou régénérez une clé compromise immédiatement