Lister les questions
curl --request GET \
--url https://api.zelinqa.ai/v1/configuration/questions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.zelinqa.ai/v1/configuration/questions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.zelinqa.ai/v1/configuration/questions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"request_id": "req_1006",
"state": "published",
"total": 3,
"next_cursor": null,
"questions": [
{
"id": "q_style",
"text": "Quel style de canapé recherchez-vous ?",
"type": "single_choice",
"selection_mode": "single",
"source": "llm_generated",
"dimension_id": "so_besoin",
"active": true,
"choices": [
{
"id": "choice_contemporain",
"label": "Contemporain"
},
{
"id": "choice_scandinave",
"label": "Scandinave"
},
{
"id": "choice_classique",
"label": "Classique"
}
]
},
{
"id": "q_budget",
"text": "Quel budget souhaitez-vous consacrer au canapé ?",
"type": "open",
"selection_mode": null,
"source": "user",
"dimension_id": "so_budget",
"active": true,
"choices": []
}
]
}{
"code": "unauthorized",
"message": "Clé d'intégration absente ou invalide.",
"request_id": "req_9000",
"details": {}
}{
"code": "insufficient_scope",
"message": "Cette clé ne permet pas de publier une configuration.",
"request_id": "req_9001",
"details": {
"required_scopes": [
"configuration:publish"
],
"granted_scopes": [
"configuration:read",
"configuration:write"
]
}
}{
"code": "unknown_configuration",
"message": "Aucun brouillon n'existe pour cette configuration.",
"request_id": "req_9008",
"details": {
"state": "draft"
}
}Configuration
Lister les questions
Liste paginée et filtrable du corpus. format=csv renvoie le même jeu de
données en text/csv, colonnes stables et documentées, pour export vers un
tableur ou réimport.
La pagination est par curseur opaque : passer cursor reçu dans
next_cursor pour obtenir la page suivante. next_cursor vaut null sur
la dernière page.
GET
/
v1
/
configuration
/
questions
Lister les questions
curl --request GET \
--url https://api.zelinqa.ai/v1/configuration/questions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.zelinqa.ai/v1/configuration/questions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.zelinqa.ai/v1/configuration/questions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"request_id": "req_1006",
"state": "published",
"total": 3,
"next_cursor": null,
"questions": [
{
"id": "q_style",
"text": "Quel style de canapé recherchez-vous ?",
"type": "single_choice",
"selection_mode": "single",
"source": "llm_generated",
"dimension_id": "so_besoin",
"active": true,
"choices": [
{
"id": "choice_contemporain",
"label": "Contemporain"
},
{
"id": "choice_scandinave",
"label": "Scandinave"
},
{
"id": "choice_classique",
"label": "Classique"
}
]
},
{
"id": "q_budget",
"text": "Quel budget souhaitez-vous consacrer au canapé ?",
"type": "open",
"selection_mode": null,
"source": "user",
"dimension_id": "so_budget",
"active": true,
"choices": []
}
]
}{
"code": "unauthorized",
"message": "Clé d'intégration absente ou invalide.",
"request_id": "req_9000",
"details": {}
}{
"code": "insufficient_scope",
"message": "Cette clé ne permet pas de publier une configuration.",
"request_id": "req_9001",
"details": {
"required_scopes": [
"configuration:publish"
],
"granted_scopes": [
"configuration:read",
"configuration:write"
]
}
}{
"code": "unknown_configuration",
"message": "Aucun brouillon n'existe pour cette configuration.",
"request_id": "req_9008",
"details": {
"state": "draft"
}
}Autorisations
Paramètres de requête
open: réponse libre, aucun choix ;single_choice: un seul choix parmi la liste ;multiple_choice: plusieurs choix possibles ;semi_open: choix proposés, complément libre autorisé viastructured_answer.free_text.
Pour semi_open, selection_mode précise si un ou plusieurs choix sont
permis en plus du complément libre.
Options disponibles:
open, single_choice, multiple_choice, semi_open Réponse
Page de questions, ou export complet en CSV.