# Documents légaux

> Lire les CGU, CGV et documents RGPD publiés pour votre application et les rendre avec les informations de votre client.

Les [documents légaux](/v1.0/glossaire#document-légal) de votre application (CGV, CGU, charte RGPD, accords de traitement des données) sont rédigés et versionnés dans la console : voir [Documents légaux](/v1.0/documents-legaux). L'API permet à votre serveur de les lire et de les afficher, par exemple dans un parcours d'inscription ou de souscription.

**Accès** : ces endpoints n'acceptent **qu'une clé API** (`x-api-key`) ; un jeton d'utilisateur est refusé avec `401` `Cle API manquante (header x-api-key)`. Appelez-les depuis votre serveur.

## L'objet Document légal

| Champ | Type | Description |
|---|---|---|
| `id` | UUID | Identifiant de la version |
| `documentType` | chaîne | `CGV`, `CGU`, `CHARTE_RGPD`, `DPA` ou `DPA_HDS` |
| `version` | chaîne | Numéro de version |
| `isActive` | booléen | `true` pour la version en vigueur de ce type |
| `effectiveDate` | chaîne ISO 8601 | Date d'entrée en vigueur |
| `content` | chaîne | Texte du document, avec des emplacements `{{namespace.champ}}` à remplacer au rendu |

## Lister les documents de l'application

::endpoint{method="GET" path="/api/legal-documents"}

Renvoie **toutes** les versions de tous les types, actives et historiques, contenu compris.

| Paramètre de requête | Type | Obligatoire | Description |
|---|---|---|---|
| `appWid` | chaîne | oui | Identifiant court de l'application |

```bash
curl -s "https://api.wakastart.app/api/legal-documents?appWid=EXAPP1" \
  -H "x-api-key: sk_test_exemple"
```

**Réponse `200`**

```json
[
  {
    "id": "5a4b3c2d-9999-4e1f-8a2b-3c4d5e6f7a88",
    "documentType": "CGU",
    "version": "3",
    "isActive": true,
    "effectiveDate": "2026-09-01T00:00:00.000Z",
    "content": "Les présentes conditions sont conclues entre {{entity.legalName}} et …"
  }
]
```

## Lire le document en vigueur d'un type

::endpoint{method="GET" path="/api/legal-documents/default"}

| Paramètre de requête | Type | Obligatoire | Description |
|---|---|---|---|
| `appWid` | chaîne | oui | Identifiant court de l'application |
| `documentType` | chaîne | non | `CGV` (défaut), `CGU`, `CHARTE_RGPD`, `DPA` ou `DPA_HDS` |

```bash
curl -s "https://api.wakastart.app/api/legal-documents/default?appWid=EXAPP1&documentType=CGU" \
  -H "x-api-key: sk_test_exemple"
```

Réponse : l'objet Document légal de la version en vigueur.

**Erreurs** : `404` `Aucun document légal actif de type <type> pour cette application`.

## Rendre un document

::endpoint{method="POST" path="/api/legal-documents/{id}/render"}

Remplace les emplacements `{{…}}` du document par les informations fournies et renvoie le texte prêt à afficher. `id` : identifiant de la version, lu dans l'une des deux listes précédentes.

| Champ | Type | Obligatoire | Contraintes |
|---|---|---|---|
| `entity.entityName` | chaîne | oui | 200 caractères au plus |
| `entity.legalCountry` | chaîne | oui | 100 caractères au plus |
| `entity.legalName` | chaîne | non | 200 caractères au plus |
| `entity.legalForm` | chaîne | non | 100 caractères au plus |
| `entity.businessRegistrationId` | chaîne | non | 100 caractères au plus (SIREN, par exemple) |
| `entity.commercialRegistryNumber` | chaîne | non | 100 caractères au plus |
| `entity.vatNumber` | chaîne | non | 50 caractères au plus |
| `entity.fiscalYearEnd` | chaîne | non | 20 caractères au plus |
| `entity.address` | objet | non | `street1`, `street2`, `street3` (200 caractères au plus), `postalCode` (20), `city`, `country` (100) |
| `contact.firstname`, `contact.lastname` | chaîne | oui | 100 caractères au plus |
| `contact.email` | chaîne | oui | E-mail, 255 caractères au plus |
| `contact.job` | chaîne | non | 100 caractères au plus |
| `date` | chaîne ISO 8601 | non | Date portée dans le document |

```bash
curl -s -X POST https://api.wakastart.app/api/legal-documents/5a4b3c2d-9999-4e1f-8a2b-3c4d5e6f7a88/render \
  -H "x-api-key: sk_test_exemple" \
  -H 'Content-Type: application/json' \
  -d '{
    "entity": {
      "entityName": "Clinique Exemple",
      "legalName": "Clinique Exemple SAS",
      "legalForm": "SAS",
      "legalCountry": "France",
      "address": { "street1": "12 rue de l'\''Exemple", "postalCode": "75011", "city": "Paris", "country": "France" }
    },
    "contact": { "firstname": "Alice", "lastname": "Martin", "email": "alice@clinique-exemple.fr" }
  }'
```

**Réponse `200`**

```json
{ "rendered": "Les présentes conditions sont conclues entre Clinique Exemple SAS et …" }
```

**Erreurs** : `400` `Validation failed (uuid is expected)` ; `404` `LegalDocument "<id>" not found`.
