> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelinqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence API V1

> Base URL, ressources et règles essentielles du contrat public Zelinqa.

## Base URL

```text theme={null}
https://api.zelinqa.ai
```

Toutes les routes applicatives utilisent HTTPS et une clé API, sauf `GET /v1/health`.

## Runtime de session

| Méthode | Route | Rôle |
| - | - | - |
| `POST` | `/v1/sessions` | Créer une conversation. |
| `POST` | `/v1/sessions/{session_id}/next` | Appliquer le tour précédent et obtenir la prochaine décision. |
| `POST` | `/v1/sessions/{session_id}/events` | Ajouter un contexte ou une donnée sans sélectionner de question. |
| `GET` | `/v1/sessions/{session_id}` | Lire et reprendre l'état public. |
| `POST` | `/v1/sessions/{session_id}/feedback` | Enregistrer le résultat métier. |

## Configuration

| Méthode | Route | Scope principal |
| - | - | - |
| `GET` | `/v1/configuration` | `configuration:read` |
| `GET` | `/v1/configuration/questions` | `configuration:read` |
| `GET` | `/v1/configuration/audit` | `configuration:publish` |
| `POST` | `/v1/configuration/changes` | `configuration:write` |
| `POST` | `/v1/configuration/publish` | `configuration:publish` |
| `GET` | `/v1/configuration/compilations/{compilation_id}` | `configuration:read` |

La référence interactive de chaque route est générée par Mintlify depuis le contrat OpenAPI V1 du moteur. Le contrat, et non cette prose, fait foi pour les champs, types et codes HTTP.

<CardGroup cols={2}>
  <Card title="Authentification et concurrence" icon="lock" href="/fr/api-reference/auth-concurrency">
    Comprendre les scopes, `Idempotency-Key` et `state_version`.
  </Card>

  <Card title="Erreurs" icon="triangle-exclamation" href="/fr/api-reference/errors">
    Distinguer les erreurs métier des refus de la passerelle et choisir une reprise.
  </Card>

  <Card title="Lire une décision" icon="list-check" href="/fr/api-reference/decision-signals">
    Comprendre les avertissements, le mode dégradé et les raisons d'arrêt.
  </Card>
</CardGroup>

<Warning>
  Les routes `/v1/next-questions` et `/v1/sessions/{session_id}/conversion` sont dépréciées. Pour toute nouvelle intégration, utilisez les routes de session ci-dessus.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.