docs: document sdk_conversation_id and multi-turn session flow

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-25 21:01:03 +00:00
parent 9b68f772f6
commit ad38cf7eaf
2 changed files with 29 additions and 3 deletions
@@ -81,3 +81,23 @@ curl -X POST http://localhost:8000/api/requests \
 curl http://localhost:8000/api/requests/ID_RICHIESTA \
  -H "X-Api-Key: TUA_KEY"
 ```
+
+### Sessioni multi-turn
+
+```bash
+# Primo messaggio: session_id "new" o un ID personalizzato
+curl -X POST http://localhost:8000/api/requests \
+  -H "X-Api-Key: TUA_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"prompt": "Mi chiamo Marco.", "topic_id": "ID_TOPIC", "session_id": "new"}'
+
+# Il risultato contiene il session_id (generato dall'SDK)
+# Usalo per i messaggi successivi nella stessa conversazione
+curl -X POST http://localhost:8000/api/requests \
+  -H "X-Api-Key: TUA_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"prompt": "Come mi chiamo?", "topic_id": "ID_TOPIC", "session_id": "SESSION_ID_DAL_RISULTATO"}'
+```
+
+Il campo `sdk_conversation_id` nella risposta contiene l'ID interno della conversazione
+Claude Code SDK, usato automaticamente per il resume nei turni successivi.