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"

{
  "requests_today": 12,
  "requests_this_month": 247,
  "quota_limit": 1000,
  "active_keys": 2
}

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",
  "message": "Template enregistre avec succes"
}

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 -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": "Acme Corp",
    "siret_client": "12345678901234",
    "montant_ht": "1250.00",
    "tva": "250.00",
    "montant_ttc": "1500.00"
  }' \
  -o facture.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), mettez les variables dans un tableau Word :

# Ligne du tableau Word
{{lignes.description}}  |  {{lignes.prix}}

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

L'API dupliquera automatiquement la ligne pour chaque element du tableau.

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"}]
  ]
}

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
-F "signature=@signature.png"
-F 'json_data={"signature": "signature"}'

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."}