Skip to main content
GET
Lire la configuration éditoriale

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

published exige configuration:read. draft exige configuration:write : lire un brouillon revient à voir du travail non publié, ce qui relève de l'édition plutôt que de la consultation.

Ce contrôle est dynamique, appliqué par le service, pas par l'authorizer. L'authorizer de la passerelle décide à partir de la méthode et du chemin ; il ne voit pas les paramètres de requête et ne peut donc pas distinguer ?state=draft de ?state=published. Il n'exige ici que configuration:read, et le service refuse ensuite avec 403 insufficient_scope si state=draft est demandé sans configuration:write.

Options disponibles:
published,
draft

Réponse

Configuration demandée.

Les quatre objets visibles dans NBQ Studio. Ni prototypes de réponse, ni graphe de relations, ni matrices, ni artefact compilé n'apparaissent ici : ce sont des internes de compilation.

request_id
string
requis
state
enum<string>
requis
Options disponibles:
published,
draft
objective
object
requis

Champs volontairement absents en V1 : min_turns_before_auto_complete, retention_mode, business_weight, et toute version de corpus choisie par le client.

sub_objectives
object[]
requis
success_informations
object[]
requis
questions
object[]
requis
configuration_version
string | null

Renseignée pour published, nulle pour un brouillon jamais publié.

draft_revision
integer | null

Renseignée pour draft, à passer en expected_draft_revision lors de la publication.

published_at
string<date-time> | null