Référence · 6 opérations

support

Le contrat ne décrit pas cette famille.

Les descriptions viennent du contrat, rédigé en français sans accents. Elles sont reproduites telles quelles pour rester la source de vérité.

Demandes d'assistance

GET/api/v1/support/requests

Les demandes de l'appelant ; toutes celles de l'institution avec `support.read_all`.

Identifiant de l'opération supportListRequests

Authentification et permissions

Le contrat ne déclare pas d'authentification par opération. Règle générale : un jeton porteur dans l'en-tête Authorization. Permissions : le contrat ne les déclare pas par opération. Lire la règle d'authentification

Paramètres de requête

scope"mine" | "institution"facultatif
default: "mine"
limitintegerfacultatif
minimum: 1 · maximum: 100 · default: 25
offsetintegerfacultatif
minimum: 0 · maximum: 100000 · default: 0

Corps de la requête

Aucun corps de requête.

Réponses

200Réponse réussieapplication/jsonarray<SupportRequestOut>
422Erreur de validationapplication/jsonHTTPValidationError

Requêtebash

# Jeton porteur si l'opération l'exige
curl -X GET "$NEXCLARA_API_URL/api/v1/support/requests" \
  -H "Authorization: Bearer $NEXCLARA_TOKEN"

Réponse 200json

[
  {
    "app_version": "exemple",
    "category": "functional",
    "created_at": "2026-10-15T09:30:00Z",
    "description": "exemple",
    "id": "00000000-0000-4000-8000-000000000001",
    "impact": "blocking",
    "module": "admin",
    "pilot_step": null,
    "priority": "critical",
    "priority_reason": "enhancement_request",
    "public_note": null,
    "reference": "DEMO-0001",
    "requester_note": null,
    "row_version": 1,
    "status": "created",
    "summary": "exemple",
    "transmitted": false,
    "transmitted_at": null,
    "updated_at": "2026-10-15T09:30:00Z"
  }
]

Exemple synthétique généré depuis le contrat et validé contre son schéma. Les clés libres « exemple » sont illustratives.

Creer une demande d'assistance

POST/api/v1/support/requests

Cree la demande ; la meme cle d'idempotence rend la meme demande (statut 200).

Identifiant de l'opération supportCreateRequest

Authentification et permissions

Corps de la requête

application/jsonSupportRequestInrequis

Champs du corps

category"functional" | "calibration" | "import" | "access" | "defect" | "security" | "compliance" | "pilot" | "report" | "enhancement"requis
descriptionstringrequis
minLength: 20 · maxLength: 4000
idempotency_keystring (uuid)requis
Tiree une fois par formulaire : la meme cle rend la meme demande.
impact"blocking" | "degraded" | "none"requis
module"admin" | "desk" | "link" | "trust" | "policies" | "pilot" | "reports" | "platform"requis
pilot_stepstring | nullfacultatif
Etape du pilote (ADR-0070), facultative ; forme `[a-z][a-z0-9_.]{1,63}`.
maxLength: 64
summarystringrequis
minLength: 8 · maxLength: 120

Réponses

200Deja creee.application/jsonSupportRequestOut
Champs de la réponse 200
- app_versionstringrequis
- category"functional" | "calibration" | "import" | "access" | "defect" | "security" | "compliance" | "pilot" | "report" | "enhancement"requis
- created_atstring (date-time)requis
- descriptionstringrequis
- idstring (uuid)requis
- impact"blocking" | "degraded" | "none"requis
- module"admin" | "desk" | "link" | "trust" | "policies" | "pilot" | "reports" | "platform"requis
- pilot_stepstring | nullrequis
- priority"critical" | "high" | "normal" | "low"requis
- priority_reason"enhancement_request" | "security_blocking" | "security_category" | "blocking_impact" | "degraded_impact" | "no_operational_impact" | "requalified_by_nexclara"requis
- public_notestring | nullrequis
  Derniere note publique de NEXCLARA.
- referencestringrequis
- requester_notestring | nullrequis
- row_versionintegerrequis
- status"created" | "qualified" | "assigned" | "in_progress" | "awaiting_information" | "resolved" | "closed"requis
- summarystringrequis
- transmittedbooleanrequis
  Vrai si la DERNIERE revision a ete remise a CONTROL par l'agent.
- transmitted_atstring (date-time) | nullrequis
- updated_atstring (date-time)requis
201Réponse réussieapplication/jsonSupportRequestOut
Champs de la réponse 201
- app_versionstringrequis
- category"functional" | "calibration" | "import" | "access" | "defect" | "security" | "compliance" | "pilot" | "report" | "enhancement"requis
- created_atstring (date-time)requis
- descriptionstringrequis
- idstring (uuid)requis
- impact"blocking" | "degraded" | "none"requis
- module"admin" | "desk" | "link" | "trust" | "policies" | "pilot" | "reports" | "platform"requis
- pilot_stepstring | nullrequis
- priority"critical" | "high" | "normal" | "low"requis
- priority_reason"enhancement_request" | "security_blocking" | "security_category" | "blocking_impact" | "degraded_impact" | "no_operational_impact" | "requalified_by_nexclara"requis
- public_notestring | nullrequis
  Derniere note publique de NEXCLARA.
- referencestringrequis
- requester_notestring | nullrequis
- row_versionintegerrequis
- status"created" | "qualified" | "assigned" | "in_progress" | "awaiting_information" | "resolved" | "closed"requis
- summarystringrequis
- transmittedbooleanrequis
  Vrai si la DERNIERE revision a ete remise a CONTROL par l'agent.
- transmitted_atstring (date-time) | nullrequis
- updated_atstring (date-time)requis
422Erreur de validationapplication/jsonHTTPValidationError

Requêtebash

# Jeton porteur si l'opération l'exige
curl -X POST "$NEXCLARA_API_URL/api/v1/support/requests" \
  -H "Authorization: Bearer $NEXCLARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "category": "functional",
  "description": "exemple-exemple-exemple",
  "idempotency_key": "00000000-0000-4000-8000-000000000001",
  "impact": "blocking",
  "module": "admin",
  "pilot_step": null,
  "summary": "exemple-exemple"
}'

Réponse 200json

{
  "app_version": "exemple",
  "category": "functional",
  "created_at": "2026-10-15T09:30:00Z",
  "description": "exemple",
  "id": "00000000-0000-4000-8000-000000000001",
  "impact": "blocking",
  "module": "admin",
  "pilot_step": null,
  "priority": "critical",
  "priority_reason": "enhancement_request",
  "public_note": null,
  "reference": "DEMO-0001",
  "requester_note": null,
  "row_version": 1,
  "status": "created",
  "summary": "exemple",
  "transmitted": false,
  "transmitted_at": null,
  "updated_at": "2026-10-15T09:30:00Z"
}

Exemple synthétique généré depuis le contrat et validé contre son schéma. Les clés libres « exemple » sont illustratives.

Une demande et sa chronologie

GET/api/v1/support/requests/{request_id}

La demande, sa chronologie, et si l'appelant en est le demandeur.

Identifiant de l'opération supportGetRequest

Authentification et permissions

Paramètres de chemin

request_idstring (uuid)requis

Corps de la requête

Aucun corps de requête.

Réponses

200Réponse réussieapplication/jsonSupportRequestDetailOut
Champs de la réponse 200
- eventsarray<SupportEventOut>requis
- is_requesterbooleanrequis
- requestSupportRequestOutrequis
422Erreur de validationapplication/jsonHTTPValidationError

Requêtebash

# Jeton porteur si l'opération l'exige
curl -X GET "$NEXCLARA_API_URL/api/v1/support/requests/00000000-0000-4000-8000-000000000001" \
  -H "Authorization: Bearer $NEXCLARA_TOKEN"

Réponse 200json

{
  "events": [
    {
      "by_nexclara": false,
      "by_requester": false,
      "from_status": null,
      "id": "00000000-0000-4000-8000-000000000001",
      "kind": "created",
      "note": null,
      "occurred_at": "2026-10-15T09:30:00Z",
      "to_status": null
    }
  ],
  "is_requester": false,
  "request": {
    "app_version": "exemple",
    "category": "functional",
    "created_at": "2026-10-15T09:30:00Z",
    "description": "exemple",
    "id": "00000000-0000-4000-8000-000000000002",
    "impact": "blocking",
    "module": "admin",
    "pilot_step": null,
    "priority": "critical",
    "priority_reason": "enhancement_request",
    "public_note": null,
    "reference": "DEMO-0001",
    "requester_note": null,
    "row_version": 1,
    "status": "created",
    "summary": "exemple",
    "transmitted": false,
    "transmitted_at": null,
    "updated_at": "2026-10-15T09:30:00Z"
  }
}

Exemple synthétique généré depuis le contrat et validé contre son schéma. Les clés libres « exemple » sont illustratives.

Confirmer la resolution

POST/api/v1/support/requests/{request_id}/confirmation

Le demandeur confirme la resolution : la demande est close.

Identifiant de l'opération supportConfirmResolution

Authentification et permissions

Paramètres de chemin

request_idstring (uuid)requis

Corps de la requête

application/jsonSupportVersionInrequis

Champs du corps

row_versionintegerrequis
minimum: 1

Réponses

200Réponse réussieapplication/jsonSupportRequestOut
Champs de la réponse 200
- app_versionstringrequis
- category"functional" | "calibration" | "import" | "access" | "defect" | "security" | "compliance" | "pilot" | "report" | "enhancement"requis
- created_atstring (date-time)requis
- descriptionstringrequis
- idstring (uuid)requis
- impact"blocking" | "degraded" | "none"requis
- module"admin" | "desk" | "link" | "trust" | "policies" | "pilot" | "reports" | "platform"requis
- pilot_stepstring | nullrequis
- priority"critical" | "high" | "normal" | "low"requis
- priority_reason"enhancement_request" | "security_blocking" | "security_category" | "blocking_impact" | "degraded_impact" | "no_operational_impact" | "requalified_by_nexclara"requis
- public_notestring | nullrequis
  Derniere note publique de NEXCLARA.
- referencestringrequis
- requester_notestring | nullrequis
- row_versionintegerrequis
- status"created" | "qualified" | "assigned" | "in_progress" | "awaiting_information" | "resolved" | "closed"requis
- summarystringrequis
- transmittedbooleanrequis
  Vrai si la DERNIERE revision a ete remise a CONTROL par l'agent.
- transmitted_atstring (date-time) | nullrequis
- updated_atstring (date-time)requis
422Erreur de validationapplication/jsonHTTPValidationError

Requêtebash

# Jeton porteur si l'opération l'exige
curl -X POST "$NEXCLARA_API_URL/api/v1/support/requests/00000000-0000-4000-8000-000000000001/confirmation" \
  -H "Authorization: Bearer $NEXCLARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "row_version": 1
}'

Réponse 200json

{
  "app_version": "exemple",
  "category": "functional",
  "created_at": "2026-10-15T09:30:00Z",
  "description": "exemple",
  "id": "00000000-0000-4000-8000-000000000001",
  "impact": "blocking",
  "module": "admin",
  "pilot_step": null,
  "priority": "critical",
  "priority_reason": "enhancement_request",
  "public_note": null,
  "reference": "DEMO-0001",
  "requester_note": null,
  "row_version": 1,
  "status": "created",
  "summary": "exemple",
  "transmitted": false,
  "transmitted_at": null,
  "updated_at": "2026-10-15T09:30:00Z"
}

Exemple synthétique généré depuis le contrat et validé contre son schéma. Les clés libres « exemple » sont illustratives.

Repondre a une demande d'information

POST/api/v1/support/requests/{request_id}/information

Le demandeur repond ; la demande revient en traitement chez NEXCLARA.

Identifiant de l'opération supportProvideInformation

Authentification et permissions

Paramètres de chemin

request_idstring (uuid)requis

Corps de la requête

application/jsonSupportNoteInrequis

Champs du corps

notestringrequis
minLength: 10 · maxLength: 2000
row_versionintegerrequis
minimum: 1

Réponses

200Réponse réussieapplication/jsonSupportRequestOut
Champs de la réponse 200
- app_versionstringrequis
- category"functional" | "calibration" | "import" | "access" | "defect" | "security" | "compliance" | "pilot" | "report" | "enhancement"requis
- created_atstring (date-time)requis
- descriptionstringrequis
- idstring (uuid)requis
- impact"blocking" | "degraded" | "none"requis
- module"admin" | "desk" | "link" | "trust" | "policies" | "pilot" | "reports" | "platform"requis
- pilot_stepstring | nullrequis
- priority"critical" | "high" | "normal" | "low"requis
- priority_reason"enhancement_request" | "security_blocking" | "security_category" | "blocking_impact" | "degraded_impact" | "no_operational_impact" | "requalified_by_nexclara"requis
- public_notestring | nullrequis
  Derniere note publique de NEXCLARA.
- referencestringrequis
- requester_notestring | nullrequis
- row_versionintegerrequis
- status"created" | "qualified" | "assigned" | "in_progress" | "awaiting_information" | "resolved" | "closed"requis
- summarystringrequis
- transmittedbooleanrequis
  Vrai si la DERNIERE revision a ete remise a CONTROL par l'agent.
- transmitted_atstring (date-time) | nullrequis
- updated_atstring (date-time)requis
422Erreur de validationapplication/jsonHTTPValidationError

Requêtebash

# Jeton porteur si l'opération l'exige
curl -X POST "$NEXCLARA_API_URL/api/v1/support/requests/00000000-0000-4000-8000-000000000001/information" \
  -H "Authorization: Bearer $NEXCLARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "Exemple synthetique",
  "row_version": 1
}'

Réponse 200json

{
  "app_version": "exemple",
  "category": "functional",
  "created_at": "2026-10-15T09:30:00Z",
  "description": "exemple",
  "id": "00000000-0000-4000-8000-000000000001",
  "impact": "blocking",
  "module": "admin",
  "pilot_step": null,
  "priority": "critical",
  "priority_reason": "enhancement_request",
  "public_note": null,
  "reference": "DEMO-0001",
  "requester_note": null,
  "row_version": 1,
  "status": "created",
  "summary": "exemple",
  "transmitted": false,
  "transmitted_at": null,
  "updated_at": "2026-10-15T09:30:00Z"
}

Exemple synthétique généré depuis le contrat et validé contre son schéma. Les clés libres « exemple » sont illustratives.

Rouvrir une demande resolue

POST/api/v1/support/requests/{request_id}/reopening

Le demandeur rouvre, en disant pourquoi.

Identifiant de l'opération supportReopenRequest

Authentification et permissions

Paramètres de chemin

request_idstring (uuid)requis

Corps de la requête

application/jsonSupportNoteInrequis

Champs du corps

notestringrequis
minLength: 10 · maxLength: 2000
row_versionintegerrequis
minimum: 1

Réponses

200Réponse réussieapplication/jsonSupportRequestOut
Champs de la réponse 200
- app_versionstringrequis
- category"functional" | "calibration" | "import" | "access" | "defect" | "security" | "compliance" | "pilot" | "report" | "enhancement"requis
- created_atstring (date-time)requis
- descriptionstringrequis
- idstring (uuid)requis
- impact"blocking" | "degraded" | "none"requis
- module"admin" | "desk" | "link" | "trust" | "policies" | "pilot" | "reports" | "platform"requis
- pilot_stepstring | nullrequis
- priority"critical" | "high" | "normal" | "low"requis
- priority_reason"enhancement_request" | "security_blocking" | "security_category" | "blocking_impact" | "degraded_impact" | "no_operational_impact" | "requalified_by_nexclara"requis
- public_notestring | nullrequis
  Derniere note publique de NEXCLARA.
- referencestringrequis
- requester_notestring | nullrequis
- row_versionintegerrequis
- status"created" | "qualified" | "assigned" | "in_progress" | "awaiting_information" | "resolved" | "closed"requis
- summarystringrequis
- transmittedbooleanrequis
  Vrai si la DERNIERE revision a ete remise a CONTROL par l'agent.
- transmitted_atstring (date-time) | nullrequis
- updated_atstring (date-time)requis
422Erreur de validationapplication/jsonHTTPValidationError

Requêtebash

# Jeton porteur si l'opération l'exige
curl -X POST "$NEXCLARA_API_URL/api/v1/support/requests/00000000-0000-4000-8000-000000000001/reopening" \
  -H "Authorization: Bearer $NEXCLARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "Exemple synthetique",
  "row_version": 1
}'

Réponse 200json

{
  "app_version": "exemple",
  "category": "functional",
  "created_at": "2026-10-15T09:30:00Z",
  "description": "exemple",
  "id": "00000000-0000-4000-8000-000000000001",
  "impact": "blocking",
  "module": "admin",
  "pilot_step": null,
  "priority": "critical",
  "priority_reason": "enhancement_request",
  "public_note": null,
  "reference": "DEMO-0001",
  "requester_note": null,
  "row_version": 1,
  "status": "created",
  "summary": "exemple",
  "transmitted": false,
  "transmitted_at": null,
  "updated_at": "2026-10-15T09:30:00Z"
}

Exemple synthétique généré depuis le contrat et validé contre son schéma. Les clés libres « exemple » sont illustratives.