Aller au contenu principal
Imports

Déposer un document

Dépose un document et ses métadonnées. La requête est un envoi multipart/form-data composé de deux parties :

POST
/v1/imports
  • file — le fichier PDF du document (obligatoire) ;
  • data — un objet JSON décrivant la source, les contacts, les adresses et les métadonnées du document (obligatoire).

Le document est traité pendant l'appel : un projet est créé ou retrouvé, puis le document lui est rattaché. La réponse 201 contient le lien du projet et son identifiant.

Authorizationstringheaderobligatoire

Clé API de l'organisation, transmise en Authorization: Bearer <clé_api>.

X-API-Versionstringheaderobligatoire

Version du contrat au format AAAA.MM (année.mois). Version courante : 2026.12-beta1.

Motif: ^\d{4}\.\d{2}(-[a-z0-9]+)?$
Exemple: 2026.12-beta1

Corps

multipart/form-data
dataobjectobligatoire

Contenu JSON de la partie data.

filestringobligatoire

Fichier PDF du document (20 Mo maximum).

Réponse

application/json

Document accepté et traité ; le projet a été créé ou retrouvé.

projectIdintegerobligatoire

Identifiant du projet.

urlstringobligatoire

Lien vers le projet créé ou retrouvé.