Consulter les Chats
Gérez et consultez vos conversations via l'API
by Arkangel AI Team•1 min read
Apprenez à lister, interroger et gérer vos conversations avec l'API Arkangel AI.
Lister les Conversations
Point d'Accès
GET https://api.arkangelai.com/v1/conversations
Exemple
curl https://api.arkangelai.com/v1/conversations \
-H "Authorization: Bearer votre_cle_api"
Paramètres de Requête
| Paramètre | Type | Description |
|---|---|---|
limit |
number | Nombre maximum de résultats (max : 100) |
offset |
number | Nombre de résultats à ignorer |
start_date |
string | Date de début (ISO 8601) |
end_date |
string | Date de fin (ISO 8601) |
Réponse
{
"conversations": [
{
"id": "conv_abc123",
"title": "Question sur le diabète",
"message_count": 5,
"created_at": "2026-01-19T10:00:00Z",
"updated_at": "2026-01-19T10:30:00Z"
}
],
"total": 42,
"has_more": true
}
Obtenir une Conversation
curl https://api.arkangelai.com/v1/conversations/conv_abc123 \
-H "Authorization: Bearer votre_cle_api"
Réponse
{
"id": "conv_abc123",
"title": "Question sur le diabète",
"messages": [
{
"id": "msg_001",
"role": "user",
"content": "Qu'est-ce que le diabète de type 2 ?",
"created_at": "2026-01-19T10:00:00Z"
},
{
"id": "msg_002",
"role": "assistant",
"content": "Le diabète de type 2 est une condition chronique...",
"sources": [...],
"created_at": "2026-01-19T10:00:05Z"
}
],
"created_at": "2026-01-19T10:00:00Z",
"updated_at": "2026-01-19T10:30:00Z"
}
Rechercher dans les Conversations
curl "https://api.arkangelai.com/v1/conversations/search?q=diabète" \
-H "Authorization: Bearer votre_cle_api"
Paramètres de Recherche
| Paramètre | Type | Description |
|---|---|---|
q |
string | Terme de recherche |
limit |
number | Nombre maximum de résultats |
Mettre à Jour une Conversation
Vous pouvez mettre à jour le titre d'une conversation :
curl -X PATCH https://api.arkangelai.com/v1/conversations/conv_abc123 \
-H "Authorization: Bearer votre_cle_api" \
-H "Content-Type: application/json" \
-d '{"title": "Question diabète - Patient A"}'
Supprimer une Conversation
curl -X DELETE https://api.arkangelai.com/v1/conversations/conv_abc123 \
-H "Authorization: Bearer votre_cle_api"
Note : Cette action est irréversible. Tous les messages de la conversation seront supprimés.
Exporter une Conversation
Exportez une conversation dans différents formats :
curl "https://api.arkangelai.com/v1/conversations/conv_abc123/export?format=pdf" \
-H "Authorization: Bearer votre_cle_api" \
-o conversation.pdf
Formats Disponibles
| Format | Description |
|---|---|
json |
Données structurées |
pdf |
Document PDF |
txt |
Texte brut |
Exemple Complet
// Lister les conversations récentes
async function getRecentConversations() {
const response = await fetch(
'https://api.arkangelai.com/v1/conversations?limit=10',
{
headers: {
'Authorization': 'Bearer votre_cle_api'
}
}
);
const data = await response.json();
return data.conversations;
}
// Obtenir les détails d'une conversation
async function getConversation(conversationId) {
const response = await fetch(
`https://api.arkangelai.com/v1/conversations/${conversationId}`,
{
headers: {
'Authorization': 'Bearer votre_cle_api'
}
}
);
return response.json();
}
Prochaines Étapes
- Consulter l'Historique - Voir l'historique complet d'utilisation
- Référence HTTP - Codes de statut et erreurs