Documentation API
API REST v1 pour accéder aux données d'enrichissement. Base URL : /api/v1
Documentation interactive Swagger
Testez les endpoints directement depuis votre navigateur avec Swagger UI.
Endpoints disponibles
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/v1/entreprise/{siren} | Fiche entreprise par SIREN |
| GET | /api/v1/entreprise/{siren}/etablissements | Liste des établissements |
| GET | /api/v1/entreprise/{siren}/finances | Données financières |
| GET | /api/v1/entreprise/{siren}/dirigeants | Liste des dirigeants |
| GET | /api/v1/entreprise/{siren}/documents | Documents (bilans, actes) |
| GET | /api/v1/entreprise/{siren}/annonces | Annonces BODACC |
| GET | /api/v1/recherche | Recherche multi-critères (q, code_naf, forme_juridique, ville, etc.) |
| GET | /api/v1/enrichissement/domaine/{dom} | Reverse lookup domaine → SIRET via pipeline cascade |
| POST | /api/v1/enrichissement/batch | Enrichissement batch (upload CSV) |
| GET | /api/v1/suggestions | Auto-complétion via Meilisearch |
Exemple curl
# Fiche entreprise
curl http://localhost:8000/api/v1/entreprise/123456789
# Recherche
curl "http://localhost:8000/api/v1/recherche?q=hellopro&page=1&page_size=20"
# Reverse lookup
curl http://localhost:8000/api/v1/enrichissement/domaine/hellopro.fr
# Batch
curl -X POST http://localhost:8000/api/v1/enrichissement/batch \
-F "file=@domaines.csv"Format de réponse
Toutes les réponses sont en JSON. Les erreurs retournent un objet { detail: string } avec un code HTTP adapté (404, 422, 500).