Analyse d’écart
Questions et réponses de l’analyse d’écart, aperçu et application aux statuts des contrôles.
GET
/api/v1/entities/{entityId}/gap-analysis/{frameworkCode} POST /api/v1/entities/{entityId}/gap-analysis/{frameworkCode} POST /api/v1/entities/{entityId}/gap-analysis/{frameworkCode}/preview GET /api/v1/entities/{entityId}/gap-analysis/metrics GET /api/v1/entities/{entityId}/gap-analysis/{frameworkCode}
- Accès
-
Permission contrôles : lecture
(Controls.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
frameworkCode requis | chemin | string | — |
Réponse
200 · application/json
Schéma GapAnalysisStateResponse
| Champ | Type | Contraintes |
|---|---|---|
questions | GapQuestionDto[] | — |
responses | map<string, string> | — |
score | GapAnalysisScoreDto | — |
POST /api/v1/entities/{entityId}/gap-analysis/{frameworkCode}
- Accès
-
Permission contrôles : écriture
(Controls.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
frameworkCode requis | chemin | string | — |
Corps de la requête
application/json, requis
Schéma SaveGapAnalysisRequest
| Champ | Type | Contraintes |
|---|---|---|
responses requis | GapAnswerDto[] | — |
applyControlStatuses | boolean | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/gap-analysis/{frameworkCode}/preview
- Accès
-
Permission contrôles : écriture
(Controls.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
frameworkCode requis | chemin | string | — |
Corps de la requête
application/json, requis
Schéma PreviewGapAnalysisRequest
| Champ | Type | Contraintes |
|---|---|---|
responses requis | GapAnswerDto[] | — |
Réponse
200 · application/json
Schéma PreviewGapAnalysisResponse
| Champ | Type | Contraintes |
|---|---|---|
changes | ControlStatusChangeDto[] | — |
skippedControls | SkippedControlDto[] | — |
GET /api/v1/entities/{entityId}/gap-analysis/metrics
- Accès
-
Permission contrôles : lecture
(Controls.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
Réponse
200 · application/json
Schéma GapAnalysisMetricsResponse
| Champ | Type | Contraintes |
|---|---|---|
unansweredCount | integer | — |
Schémas
Objets utilisés par les opérations de cette page. Les nombres sont écrits en JSON comme des nombres ; les énumérations, comme des chaînes.
GapAnalysisStateResponse
| Champ | Type | Contraintes |
|---|---|---|
questions | GapQuestionDto[] | — |
responses | map<string, string> | — |
score | GapAnalysisScoreDto | — |
GapQuestionDto
| Champ | Type | Contraintes |
|---|---|---|
code | string | — |
question | string | — |
regulatoryReference | string | — |
domain | string | — |
domainOrder | integer | — |
order | integer | — |
relatedControlCodes | string[] | — |
GapAnalysisScoreDto
| Champ | Type | Contraintes |
|---|---|---|
overallScore | number | — |
domainScores | DomainScoreDto[] | — |
questionsTotal | integer | — |
questionsAnswered | integer | — |
DomainScoreDto
| Champ | Type | Contraintes |
|---|---|---|
domain | string | — |
score | number | — |
level | string | — |
SaveGapAnalysisRequest
| Champ | Type | Contraintes |
|---|---|---|
responses requis | GapAnswerDto[] | — |
applyControlStatuses | boolean | — |
GapAnswerDto
| Champ | Type | Contraintes |
|---|---|---|
questionId requis | string | — |
answer requis | string | — |
PreviewGapAnalysisRequest
| Champ | Type | Contraintes |
|---|---|---|
responses requis | GapAnswerDto[] | — |
PreviewGapAnalysisResponse
| Champ | Type | Contraintes |
|---|---|---|
changes | ControlStatusChangeDto[] | — |
skippedControls | SkippedControlDto[] | — |
ControlStatusChangeDto
| Champ | Type | Contraintes |
|---|---|---|
controlId | string (uuid) | — |
controlCode | string | — |
controlTitle | string | — |
fromStatus | string | — |
toStatus | string | — |
SkippedControlDto
| Champ | Type | Contraintes |
|---|---|---|
controlId | string (uuid) | — |
controlCode | string | — |
controlTitle | string | — |
status | string | — |
GapAnalysisMetricsResponse
| Champ | Type | Contraintes |
|---|---|---|
unansweredCount | integer | — |
Mise à jour : 10 octobre 2026. Signaler une inexactitude