Skip to main content
GET
Lister les questions

Autorisations

Authorization
string
header
requis

Clé d'intégration préfixée nbq_live_, envoyée dans Authorization: Bearer nbq_live_… et résolue par l'authorizer Lambda de l'API Gateway publique. L'authorizer valide la clé, puis injecte en amont du service les headers de contexte x-tenant-id, x-nbq-id et x-scopesx-scopes étant la liste des scopes de la clé séparés par des virgules, par exemple runtime,configuration:read.

Ces headers ne sont jamais acceptés depuis le client : toute valeur entrante est écrasée. Une clé absente ou invalide produit 401 au niveau de la passerelle ; une clé valide sans le scope requis produit 403 avec le code insufficient_scope.

Paramètres de requête

state
enum<string>
défaut:published

draft exige configuration:write, contrôlé par le service et non par l'authorizer, qui ne voit pas les paramètres de requête.

Options disponibles:
published,
draft
sub_objective_id
string
Required string length: 1 - 128
active
boolean

Filtre sur le drapeau d'activation.

type
enum<string>
  • 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é via structured_answer.free_text.

Le mode de sélection est porté par le type lui-même : aucun champ selection_mode séparé n'existe en V1.

Options disponibles:
open,
single_choice,
multiple_choice,
semi_open

Recherche textuelle simple sur le libellé de la question.

Required string length: 1 - 200
limit
integer
défaut:50
Plage requise: 1 <= x <= 200
cursor
string

Curseur opaque renvoyé par l'appel précédent.

Required string length: 1 - 512
format
enum<string>
défaut:json

csv ignore la pagination par curseur et renvoie l'intégralité du corpus filtré en text/csv.

Options disponibles:
json,
csv

Réponse

Page de questions, ou export complet en CSV.

request_id
string
requis
state
enum<string>
requis
Options disponibles:
published,
draft
questions
object[]
requis
next_cursor
string | null
requis

Curseur de la page suivante, null sur la dernière page.

total
integer

Nombre total de questions correspondant au filtre.

Plage requise: x >= 0