Documentation API
Authentification
Toutes les requetes necessitent une cle API dans le header:
X-API-Key: sk_votre_cle_api
POST /api/search
Lance une recherche asynchrone et retourne un job ID.
{
"company_name": "Acme SAS",
"keywords": ["Paris"] // optionnel
}
Reponse: { "jobId": "123", "statusUrl": "/api/search/status/123" }
GET /api/search/status/:jobId
Verifie le statut d'une recherche.
// Reponse si termine:
{
"status": "completed",
"siren": "123456789",
"sourceUrl": "https://pappers.fr/..."
}
POST /api/search/sync
Recherche synchrone (attend le resultat, timeout 3min max).
{
"company_name": "Acme SAS",
"timeout": 120000 // ms, optionnel
}
GET /api/status
Retourne le statut de l'API et les limites restantes.