> ## 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.

# Appels HTTP avec curl

> Créez une session et obtenez la première question avec curl.

Ce guide s'adresse aux intégrations HTTP directes. Pour commencer avec les SDK officiels, consultez le [démarrage rapide](/fr/quickstart/overview). Il vous faut une configuration publiée et une clé portant le scope `runtime`.

## 1. Créer une session

```bash theme={null}
curl --request POST 'https://api.zelinqa.ai/v1/sessions' \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: session-$(uuidgen)" \
  --data '{
    "client_reference": "lead-8842",
    "max_turns": 10
  }'
```

Conservez `session_id` et `versions.state_version` dans la réponse. Une session neuve commence à la version `0`.

## 2. Obtenir la première question

```bash theme={null}
export ZELINQA_SESSION_ID="ses_01J8Z"

curl --request POST "https://api.zelinqa.ai/v1/sessions/$ZELINQA_SESSION_ID/next" \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: next-$(uuidgen)" \
  --data '{"state_version": 0}'
```

Quand `action` vaut `ask`, affichez ou reformulez `candidates[0]`. Conservez la nouvelle valeur `versions.state_version` et, si possible, `decision_id`.

## 3. Envoyer la réponse du visiteur

```bash theme={null}
curl --request POST "https://api.zelinqa.ai/v1/sessions/$ZELINQA_SESSION_ID/next" \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: next-$(uuidgen)" \
  --data '{
    "state_version": 1,
    "previous_turn": {
      "decision_id": "dec_7f2a",
      "question_id": "q_budget",
      "assistant_text": "Quel budget souhaitez-vous consacrer au projet ?",
      "user_text": "Autour de 2 000 euros.",
      "message_id": "msg_18"
    }
  }'
```

Utilisez toujours la `state_version` réellement reçue ; la valeur `1` ci-dessus est seulement illustrative.

## 4. Enregistrer le résultat final

```bash theme={null}
curl --request POST "https://api.zelinqa.ai/v1/sessions/$ZELINQA_SESSION_ID/feedback" \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: feedback-$(uuidgen)" \
  --data '{
    "result": "success",
    "label": "lead_qualified"
  }'
```

<Tip>
  Retrouvez les schémas complets, exemples et erreurs dans la [référence API](/fr/api-reference/overview).
</Tip>


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