L
LegalSpark

Clés API et accès programmatique (à venir)

Roadmap : API publique pour créer dossiers et envoyer signatures par programmation.

Mis à jour le 1 mai 2026

PV-Express expose aujourd'hui une interface webhook sortante complète (voir Webhooks sortants HMAC) qui permet de réagir à tout événement métier depuis votre infrastructure. En revanche, il n'existe pas encore d'API publique en écriture pour créer des dossiers ou déclencher des signatures par programmation.

Cette page détaille le statut actuel et la roadmap publique.

Statut actuel (mai 2026)

CapacitéDisponibilité
Webhooks sortants HMACDisponible (8 événements typés)
API REST publique en lectureNon disponible
API REST publique en écritureNon disponible
SDK Node / Python officielsNon disponible
OAuth2 / API keys utilisateurNon disponible

Toutes les opérations métier (création société, dépôt plaquette, génération PV, envoi signature, dépôt greffe) passent aujourd'hui exclusivement par l'interface web ou par OCR plaquette. La sortie de données se fait par les webhooks ou par export manuel (CSV, ZIP pochette).

Roadmap : API publique Q4 2026

Une API REST publique est prévue pour le quatrième trimestre 2026, en accès pilote sur demande dans un premier temps. Périmètre cible :

Endpoints prévus

POST   /v1/companies                  Créer une société
GET    /v1/companies/:id              Lire une société
PATCH  /v1/companies/:id              Mettre à jour une société

POST   /v1/dossiers                   Créer un dossier AGOA
GET    /v1/dossiers/:id               Lire un dossier
POST   /v1/dossiers/:id/generate-pv   Générer le PV
POST   /v1/dossiers/:id/sign          Envoyer en signature Yousign
GET    /v1/dossiers/:id/pochette      Télécharger la pochette ZIP

GET    /v1/events                     Lister les événements (équivalent webhooks pull)

Authentification prévue

Deux modes d'authentification supportés :

  1. API key bearer — pour intégrations serveur-à-serveur d'un cabinet sur sa propre tenancy. Format pvk_live_<32_chars>. Header Authorization: Bearer pvk_live_....
  2. OAuth2 client_credentials — pour intégrations multi-cabinets (PMS, ERP, plateformes EC nationales) qui doivent agir au nom de plusieurs cabinets clients. Scopes granulaires (dossiers:read, dossiers:write, companies:write, etc.).

Les deux modes seront émis depuis Settings → Intégrations → Clés API, réservé au rôle propriétaire du cabinet (voir Permissions et rôles).

Rate limits prévus

  • 100 requêtes / minute / cabinet par défaut
  • 1 000 requêtes / minute sur demande pour les intégrations volumineuses
  • Burst toléré jusqu'à 200 req sur 10s, puis throttle linéaire
  • Headers de réponse : X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Au-delà du rate limit, réponse 429 Too Many Requests avec un header Retry-After indiquant le délai avant la prochaine fenêtre.

Versioning

L'API utilisera un versioning par préfixe d'URL (/v1, /v2...). Toute breaking change conduira à une nouvelle version majeure, l'ancienne restant supportée minimum 12 mois après dépréciation annoncée.

Idempotence

Les endpoints en écriture accepteront un header Idempotency-Key: <uuid_v4> pour permettre la rejeu sûr en cas de timeout réseau. La réponse sera mise en cache 24h pour la même clé.

Besoin urgent ? Pilote sur demande

Si votre cabinet a un cas d'usage bloquant qui nécessite l'API en écriture avant Q4 2026, contactez-nous : [email protected].

Nous étudions au cas par cas l'ouverture d'un accès pilote anticipé pour :

  • Cabinets > 500 dossiers AGOA / an
  • Éditeurs PMS souhaitant intégrer PV-Express dans leur produit
  • Fédérations ou ordres souhaitant proposer PV-Express en marque blanche

Les pilotes signent un accord d'utilisation spécifique (rate limits, SLA, retours feedback) et bénéficient d'un onboarding direct avec l'équipe technique.

Alternatives en attendant

En attendant l'API publique, plusieurs approches couvrent la majorité des cas d'usage :

  • Webhooks sortants pour toute notification d'événement métier vers vos systèmes (voir Webhooks sortants HMAC)
  • Plateforme automation (n8n, Zapier, Make) pour relayer ces webhooks vers vos outils tiers (voir Brancher n8n, Zapier, Make)
  • Import par OCR plaquette pour créer des dossiers en batch : uploadez la plaquette du client, PV-Express extrait automatiquement société + comptes + résultat
  • Export CSV des dossiers, sociétés et événements depuis Settings → Export pour alimenter votre data warehouse en pull

Pour la grande majorité des cabinets pilotes actuels, la combinaison webhooks sortants + n8n couvre les besoins d'automatisation à 90 % sans nécessiter d'API en écriture.

Restez informé

L'annonce de la disponibilité générale de l'API se fera sur :

  • Le changelog produit (Settings → Aide → Nouveautés)
  • La newsletter cabinet mensuelle
  • La page de documentation de cette section (mise à jour updatedAt)

Si vous voulez être prévenu en avant-première dès l'ouverture du pilote, envoyez-nous un email à [email protected] avec votre cas d'usage et le volume estimé de dossiers / mois.

Toutes les pages IntégrationsRetour à l'accueil documentation