API key
Bearer API key
Pour le bootstrap, les scripts internes et les intégrations légères.
- Mise en route immédiate
- Sandbox et production séparées
- Rotation depuis la console
Documentation
Quickstart & référence API
Une API REST, deux façons de vous authentifier, le même périmètre complet.
Base URL · https://www.datenza.com/v1
Quickstart
Votre premier appel en trois minutes
Choisissez une offre API payante, générez une clé, faites votre premier appel. L'enveloppe de réponse est cohérente sur tous les endpoints.
Obtenir une clé APIcURL
curl https://www.datenza.com/v1/entreprises/552081317 \ -H "Authorization: Bearer dz_live_xxx"
Authentification
Deux modes, le même périmètre
Choisissez selon votre niveau d'exigence, pas selon les fonctionnalités.
RFC 9421
HTTP Signatures Ed25519
Anti-rejeu, Content-Digest (RFC 9530), réponses signées et liées à la requête.
- Aucun secret partagé
- Nonce + timestamp vérifiés
- Réponses signées et JWKS serveur
Content-Digest: sha-256=:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=:
Signature-Input: sig1=("@method" "@target-uri" "content-digest" "@authority");created=…;keyid="dzk_…";nonce="…";alg="ed25519"
Signature: sig1=:…:
Endpoints
Le périmètre REST
| GET | /v1/recherche | Rechercher des entreprises par nom, identifiant ou dirigeant, avec filtres. |
| GET | /v1/entreprises/{siren} | Récupérer le dossier d'une entreprise (param inclure pour dirigeants, comptes, actes). |
| GET | /v1/dirigeants | Rechercher des dirigeants et leurs mandats. |
| GET | /v1/entreprises/{siren}/comptes | Comptes annuels et données financières déposées. |
| GET | /v1/entreprises/{siren}/documents | Liste et téléchargement des actes, statuts et comptes. |
| POST | /v1/surveillance | Ajouter une entité au portefeuille surveillé et déclarer un webhook. |
| POST | /v1/attestations | Générer une attestation scellée et horodatée à valeur probante. |
Webhooks
La surveillance vient à vous
Déclarez une callback_url : nous y postons chaque événement légal (modification, cession, procédure), signé pour que vous puissiez l'authentifier.
POST /v1/surveillance
{
"siren": "552081317",
"callback_url": "https://votre-app.fr/webhooks/datenza"
}Erreurs
Une enveloppe cohérente
En cas d'erreur, la réponse contient un code stable et un message lisible.
| Code | Signification |
|---|---|
| 401 | Authentification manquante ou invalide |
| 402 | Quota inclus épuisé et crédit prépayé insuffisant |
| 409 | Nonce de signature déjà utilisé (anti-rejeu) |
| 404 | Entreprise introuvable |
| 429 | Cadence trop élevée, réessayez après le délai indiqué |
Accéder à Datenza
Créez votre compte pour consulter les offres et gérer vos accès.