DocX API

En 3 etapes

1. Creez un compte gratuitInscrivez-vous sur dev.layerone.fr — 20 requetes/mois incluses.
2. Recuperez votre cle APIDans la console, cliquez "Nouvelle cle" et choisissez DocX.
3. Generez votre premier PDFCopiez la commande ci-dessous et lancez-la dans votre terminal.

Copier# Remplacez VOTRE_CLE par la cle obtenue a l'etape 2
curl -X POST https://docx.layerone.fr/render-document \
  -H "X-API-Key: VOTRE_CLE" \
  -F "template=@mon_template.docx" \
  -F 'json_data={"client": "Acme Corp", "montant": "1 500 EUR"}' \
  -o resultat.pdf

Authentification

Ajoutez votre cle API dans le header X-API-Key de chaque requete :

X-API-Key: votre_cle_api

Endpoints

Copiercurl https://docx.layerone.fr/__health

{
  "status": "ok",
  "time": "2026-04-13T12:00:00Z",
  "storage": { "templates_writable": true },
  "libreoffice": { "binary_found": true }
}

Copiercurl https://docx.layerone.fr/usage-stats \
  -H "X-API-Key: VOTRE_CLE"

{
  "success": true,
  "stats": {
    "plan": "gratuit",
    "quota": {
      "limit": 20,
      "used": 12,
      "remaining": 8
    },
    "rate_limit": "5/minute",
    "max_concurrent": 1,
    "usage": {
      "hourly": 3,
      "daily": 12,
      "burst_5min": 1
    },
    "thresholds": {
      "hourly": 500,
      "daily": 2000,
      "burst": 50
    },
    "current_concurrent": 0
  }
}

Copiercurl -X POST https://docx.layerone.fr/client/templates \
  -H "X-API-Key: VOTRE_CLE" \
  -F "template=@mon_template.docx"

{
  "template_id": "abc123",
  "name": "mon_template.docx",
  "status": "created",
  "client_name": "mon_template",
  "detected_tags": ["client_nom", "montant_ht", "lignes"],
  "validation": "ok"
}

Copiercurl -X PUT https://docx.layerone.fr/client/templates/abc123 \
  -H "X-API-Key: VOTRE_CLE" \
  -F "template=@nouveau_template.docx"

Copiercurl https://docx.layerone.fr/client/templates/abc123 \
  -H "X-API-Key: VOTRE_CLE" \
  -o template.docx

Copiercurl -X DELETE https://docx.layerone.fr/client/templates/abc123 \
  -H "X-API-Key: VOTRE_CLE"

Copiercurl https://docx.layerone.fr/client/templates \
  -H "X-API-Key: VOTRE_CLE"

Copiercurl https://docx.layerone.fr/client/templates/abc123/versions \
  -H "X-API-Key: VOTRE_CLE"

{
  "template_id": "abc123",
  "versions_count": 2,
  "versions": [
    {
      "version_id": 12,
      "version_number": 2,
      "content_hash": "a1b2c3...",
      "original_name": "devis_template.docx",
      "size_bytes": 48213,
      "archived_at": "2026-08-01T10:15:00Z"
    },
    {
      "version_id": 11,
      "version_number": 1,
      "content_hash": "9f8e7d...",
      "original_name": "devis_template.docx",
      "size_bytes": 47900,
      "archived_at": "2026-07-15T09:00:00Z"
    }
  ]
}

Copiercurl https://docx.layerone.fr/client/templates/abc123/versions/11 \
  -H "X-API-Key: VOTRE_CLE" \
  -o template_v1.docx

Copiercurl -X POST https://docx.layerone.fr/client/templates/abc123/restore/11 \
  -H "X-API-Key: VOTRE_CLE"

{
  "template_id": "abc123",
  "restored_from_version_id": 11,
  "status": "restored"
}

Copiercurl -X POST "https://docx.layerone.fr/render-document?return_signature_fields=true" \
  -H "X-API-Key: VOTRE_CLE" \
  -F "template=@devis_template.docx" \
  -F 'json_data={"client": "Acme Corp"}'

Copiercurl -X POST https://docx.layerone.fr/render-document \
  -H "X-API-Key: VOTRE_CLE" \
  -F "template=@devis_template.docx" \
  -F 'json_data={
    "client": "Acme Corp",
    "adresse": "12 rue de Paris, 75001",
    "lignes": [
      {"description": "Prestation A", "prix": "500 EUR"},
      {"description": "Prestation B", "prix": "1 000 EUR"}
    ],
    "total": "1 500 EUR"
  }' \
  -o devis.pdf

Copierimport requests, json

response = requests.post(
    "https://docx.layerone.fr/render-document",
    headers={"X-API-Key": "VOTRE_CLE"},
    files={"template": open("devis_template.docx", "rb")},
    data={"json_data": json.dumps({
        "client": "Acme Corp",
        "total": "1 500 EUR"
    })}
)

with open("devis.pdf", "wb") as f:
    f.write(response.content)

Copierconst form = new FormData();
form.append("template", fichierWord);
form.append("json_data", JSON.stringify({
  client: "Acme Corp",
  total: "1 500 EUR"
}));

const res = await fetch("https://docx.layerone.fr/render-document", {
  method: "POST",
  headers: { "X-API-Key": "VOTRE_CLE" },
  body: form
});

const pdf = await res.blob();

Copiercurl -X POST https://docx.layerone.fr/render-facturx \
  -H "X-API-Key: VOTRE_CLE" \
  -F "template=@facture_template.docx" \
  -F 'json_data={
    "numero_facture": "FA-2024-001",
    "date_facture": "2024-03-15",
    "client": {
      "nom": "Acme Corp",
      "adresse": "12 rue de Paris",
      "code_postal": "75001",
      "ville": "Paris",
      "siret": "12345678901234"
    },
    "montant_ht_total": "1250.00",
    "montant_tva_total": "250.00",
    "montant_ttc_total": "1500.00"
  }' \
  -o facture.pdf

Copiercurl -X POST https://docx.layerone.fr/attach-facturx \
  -H "X-API-Key: VOTRE_CLE" \
  -F "pdf=@facture_deja_generee.pdf" \
  -F 'json_data={
    "numero_facture": "FA-2024-001",
    "date_facture": "2024-03-15",
    "client": {
      "nom": "Acme Corp",
      "siret": "12345678901234"
    },
    "montant_ht_total": "1250.00",
    "montant_tva_total": "250.00",
    "montant_ttc_total": "1500.00"
  }' \
  -o facture_facturx.pdf

Comment creer un template

Un template est un fichier Word (.docx) classique avec des variables entre doubles accolades. L'API les remplace par vos donnees.

Exemple simple

Dans votre fichier Word, ecrivez :

Bonjour {{client}},

Veuillez trouver ci-joint votre devis d'un montant de {{total}}.

Date : {{date}}
Reference : {{reference}}

Et envoyez ce JSON :

{
  "client": "Acme Corp",
  "total": "1 500 EUR",
  "date": "15/03/2024",
  "reference": "DEV-2024-001"
}

Variables imbriquees

Vous pouvez utiliser la notation a points pour acceder a des sous-objets :

# Dans le Word
Client : {{client.nom}}
Ville : {{client.adresse.ville}}

# Dans le JSON
{
  "client": {
    "nom": "Acme Corp",
    "adresse": { "ville": "Paris" }
  }
}

Tableaux (lignes repetees)

Pour generer plusieurs lignes (ex: lignes de devis), le moteur (docxtpl/Jinja2) exige une syntaxe precise : 3 lignes de tableau Word distinctes (3 balises <w:tr> separees). Un simple {{lignes.description}} pose dans une seule cellule ne fonctionnera pas — l'API ne duplique rien toute seule sans cette syntaxe.

Ligne 1 du tableau Word (cellule vide, juste le tag) :

{%tr for item in lignes %}

Ligne 2 du tableau Word (les donnees, une cellule par colonne) :

{{ item.description }}  |  {{ item.prix }}

Ligne 3 du tableau Word (cellule vide, juste le tag) :

{%tr endfor %}

Et le JSON correspondant :

# JSON
{
  "lignes": [
    {"description": "Prestation A", "prix": "500 EUR"},
    {"description": "Prestation B", "prix": "1 000 EUR"}
  ]
}

Listes (a puces ou numerotees)

Pour repeter un paragraphe entier (ex: une liste a puces ou numerotee), le moteur (docxtpl/Jinja2) propose l'equivalent de {%tr%} mais au niveau du paragraphe : 3 paragraphes Word distincts avec les balises {%p for %} / {%p endfor %}. Un simple {{liste}} pose dans un seul paragraphe ne fonctionnera pas — l'API ne duplique rien toute seule sans cette syntaxe.

Paragraphe 1 du document Word (paragraphe vide, juste le tag) :

{%p for prestation in prestations %}

Paragraphe 2 du document Word (les donnees — c'est ce paragraphe qui doit deja porter le style Word "Liste a puces" ou "Liste numerotee", applique dans Word avant d'inserer la balise) :

{{ prestation }}

Paragraphe 3 du document Word (paragraphe vide, juste le tag) :

{%p endfor %}

Et le JSON correspondant (liste de textes simples) :

# JSON
{
  "prestations": [
    "Nettoyage de chantier",
    "Evacuation des gravats",
    "Controle final"
  ]
}

Variante avec des objets (une balise par champ dans le paragraphe 2, ex : {{ prestation.nom }} — {{ prestation.duree }}) :

# JSON
{
  "prestations": [
    {"nom": "Nettoyage de chantier", "duree": "2h"},
    {"nom": "Evacuation des gravats", "duree": "1h30"}
  ]
}

Les filtres de casse (maj, min, cap, titre — voir la section "Filtres disponibles" plus bas) s'appliquent aussi bien dans une liste que partout ailleurs, y compris sur un champ imbrique (paragraphe 2 du document Word) :

{{ prestation.nom | maj }} — {{ prestation.duree }}

La notation a points fonctionne comme partout ailleurs (voir "Variables imbriquees" plus haut) : chaque element de la liste peut etre un objet avec des sous-champs, y compris imbriques.

Enregistrer un template

Plutot que de renvoyer le fichier Word a chaque fois, enregistrez-le une fois avec POST /client/templates et reutilisez son template_id dans vos appels.

Images et photos

Vous pouvez inserer des images dynamiques dans vos templates grace au filtre photo(). Les images sont envoyees en fichiers joints (multipart) et inserees a la taille souhaitee.

Envoyer des images

Ajoutez vos images comme fichiers multipart dans la requete, avec des noms comme photo_0, photo_1, etc. Dans le JSON, referencez-les par leur nom :

Copiercurl -X POST https://docx.layerone.fr/render-document \
  -H "X-API-Key: votre_cle" \
  -F "template_id=abc123" \
  -F 'json_data={"photos": [{"image": "photo_0"}, {"image": "photo_1"}]}' \
  -F "photo_0=@photo1.jpg" \
  -F "photo_1=@photo2.jpg" \
  -F "output_format=pdf"

Le filtre photo()

Dans votre template Word, utilisez le filtre photo() pour inserer et redimensionner les images :

Mise en page : photos empilees

Par defaut, les photos s'empilent verticalement :

# Dans le template Word
{% for p in photos %}
{{ p.image | photo(120) }}
{% endfor %}

Mise en page : grille 2 colonnes

Pour afficher les photos cote a cote, inserez un tableau Word a 2 colonnes dans votre template et placez les tags dans les cellules :

# Tableau Word avec 2 cellules par ligne
| {{ row.0.image | photo(75) }} | {{ row.1.image | photo(75) }} |

Envoyez les photos regroupees par lignes de 2 dans le JSON :

{
  "rows": [
    [{"image": "photo_0"}, {"image": "photo_1"}],
    [{"image": "photo_2"}, {"image": "photo_3"}]
  ]
}

Mise en page automatique : {{ reportage_photos }}

Pour un reportage photo multi-niveaux (ex : plusieurs zones d'un chantier, chacune avec ses propres photos), placez le tag {{ reportage_photos }} seul dans un paragraphe de votre template. L'API genere automatiquement un tableau par niveau (3 photos par rangee, avec une ligne de description sous chaque rangee), dans des blocs insecables (une rangee de photos ne sera jamais coupee entre deux pages).

Fournissez vos donnees via la cle level_photo_groups dans le JSON : une liste de groupes, chacun avec un level_name (titre du niveau) et une liste photos (chaque photo reference le nom du fichier multipart via image, avec une liste optionnelle non_conformities affichee sous la photo) :

{
  "level_photo_groups": [
    {
      "level_name": "Niveau RDC",
      "photos": [
        {"image": "photo_0", "non_conformities": [
          {"description": "Garde-corps absent", "norm_reference": "NF P01-012"}
        ]},
        {"image": "photo_1"}
      ]
    },
    {
      "level_name": "Niveau R+1",
      "photos": [{"image": "photo_2"}]
    }
  ]
}

Tailles differentes par type

Vous pouvez utiliser des tailles differentes pour chaque image. Exemple : photo panoramique large + photos detail petites :

# Photo panoramique
{{ panorama.image | photo(160) }}

# Photos detail
{% for p in details %}
{{ p.image | photo(60) }}
{% endfor %}

Signatures

Les signatures fonctionnent de la meme maniere. Envoyez-les comme fichiers multipart et utilisez le filtre photo() :

# Dans le template
Signature : {{ signature | photo(50) }}

# curl — le nom du fichier DOIT commencer par "signature_"
-F "signature_0=@signature.png"
-F 'json_data={"signature": "signature_0"}'

Signature electronique

DocX propose aussi un service de signature electronique integre (via Documenso), distinct du produit "Sign" (sign.layerone.fr) mais accessible avec la meme cle X-API-Key. Il est facture sur un quota dedie (service_type="sign"), separe de votre quota de generation de documents.

Filtres disponibles

Les filtres transforment vos donnees dans le template. Syntaxe : {{ valeur | filtre }}

Codes d'erreur

En cas d'erreur, la reponse contient un champ detail qui explique le probleme.

# Exemple d'erreur
{"detail": "Quota mensuel depasse. Passez au plan superieur."}