Mises à jour de référentiels
Nouvelles versions des référentiels maîtres : liste, aperçu des différences, acceptation.
GET
/api/v1/frameworks/upgrades POST /api/v1/frameworks/upgrades/{frameworkCode}/accept GET /api/v1/frameworks/upgrades/{frameworkCode}/preview GET /api/v1/frameworks/upgrades/count GET /api/v1/frameworks/upgrades
- Accès
-
Permission contrôles : lecture
(Controls.Read), accordée par un rôle sur au moins une entité de l’organisation. - Limite de débit
- aucune
Réponse
200 · application/json
Type PendingUpgradeSummary[]
POST /api/v1/frameworks/upgrades/{frameworkCode}/accept
- Accès
-
Permissions contrôles : lecture
(Controls.Read)et référentiels : acceptation des mises à jour (Administrateur et RSSI)(Frameworks.AcceptUpgrade), accordée par un rôle sur au moins une entité de l’organisation. - 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 |
|---|---|---|---|
frameworkCode requis | chemin | string | — |
Réponse
200 · application/json
Schéma AcceptUpgradeResult
| Champ | Type | Contraintes |
|---|---|---|
organizationFrameworkId requis | string (uuid) | — |
oldAdoptedVersionNumber requis | integer | — |
newAdoptedVersionNumber requis | integer | — |
controlsAdded requis | integer | — |
controlsModified requis | integer | — |
controlsRemoved requis | integer | — |
questionsAdded requis | integer | — |
questionsModified requis | integer | — |
questionsRemoved requis | integer | — |
templatesAdded requis | integer | — |
templatesModified requis | integer | — |
templatesRemoved requis | integer | — |
newControlRowsCreated requis | integer | — |
archivedControlRows requis | integer | — |
entitiesAffected requis | integer | — |
GET /api/v1/frameworks/upgrades/{frameworkCode}/preview
- Accès
-
Permission contrôles : lecture
(Controls.Read), accordée par un rôle sur au moins une entité de l’organisation. - Limite de débit
- aucune
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
frameworkCode requis | chemin | string | — |
Réponse
200 · application/json
Schéma UpgradePreviewResponse
| Champ | Type | Contraintes |
|---|---|---|
organizationFrameworkId | string (uuid) | — |
frameworkCode | string | — |
frameworkName | string | — |
frameworkKind | string | — |
adoptedVersionNumber | integer | — |
pendingUpgradeVersionId | string (uuid) | — |
pendingUpgradeVersionNumber | integer | — |
pendingUpgradeChangeLog | string | — |
addedControls | DiffedControl[] | — |
removedControls | DiffedControl[] | — |
modifiedControls | ModifiedControl[] | — |
overrideConflicts | OverrideConflict[] | — |
addedQuestions | DiffedQuestion[] | — |
removedQuestions | DiffedQuestion[] | — |
modifiedQuestions | ModifiedQuestion[] | — |
addedTemplates | DiffedTemplate[] | — |
removedTemplates | DiffedTemplate[] | — |
modifiedTemplates | ModifiedTemplate[] | — |
isEmpty | boolean | — |
hasUnresolvedConflicts | boolean | — |
GET /api/v1/frameworks/upgrades/count
- Accès
-
Permission contrôles : lecture
(Controls.Read), accordée par un rôle sur au moins une entité de l’organisation. - Limite de débit
- aucune
Réponse
200 · application/json
Schéma PendingUpgradeCount
| Champ | Type | Contraintes |
|---|---|---|
count requis | 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.
PendingUpgradeSummary
| Champ | Type | Contraintes |
|---|---|---|
organizationFrameworkId requis | string (uuid) | — |
frameworkId requis | string (uuid) | — |
frameworkCode requis | string | — |
frameworkName requis | string | — |
frameworkKind requis | string | — |
adoptedVersionId requis | string (uuid) | — |
adoptedVersionNumber requis | integer | — |
pendingUpgradeVersionId requis | string (uuid) | — |
pendingUpgradeVersionNumber requis | integer | — |
pendingUpgradeChangeLog requis | string | — |
pendingUpgradePublishedAt requis | string (date-time) | null | — |
AcceptUpgradeResult
| Champ | Type | Contraintes |
|---|---|---|
organizationFrameworkId requis | string (uuid) | — |
oldAdoptedVersionNumber requis | integer | — |
newAdoptedVersionNumber requis | integer | — |
controlsAdded requis | integer | — |
controlsModified requis | integer | — |
controlsRemoved requis | integer | — |
questionsAdded requis | integer | — |
questionsModified requis | integer | — |
questionsRemoved requis | integer | — |
templatesAdded requis | integer | — |
templatesModified requis | integer | — |
templatesRemoved requis | integer | — |
newControlRowsCreated requis | integer | — |
archivedControlRows requis | integer | — |
entitiesAffected requis | integer | — |
UpgradePreviewResponse
| Champ | Type | Contraintes |
|---|---|---|
organizationFrameworkId | string (uuid) | — |
frameworkCode | string | — |
frameworkName | string | — |
frameworkKind | string | — |
adoptedVersionNumber | integer | — |
pendingUpgradeVersionId | string (uuid) | — |
pendingUpgradeVersionNumber | integer | — |
pendingUpgradeChangeLog | string | — |
addedControls | DiffedControl[] | — |
removedControls | DiffedControl[] | — |
modifiedControls | ModifiedControl[] | — |
overrideConflicts | OverrideConflict[] | — |
addedQuestions | DiffedQuestion[] | — |
removedQuestions | DiffedQuestion[] | — |
modifiedQuestions | ModifiedQuestion[] | — |
addedTemplates | DiffedTemplate[] | — |
removedTemplates | DiffedTemplate[] | — |
modifiedTemplates | ModifiedTemplate[] | — |
isEmpty | boolean | — |
hasUnresolvedConflicts | boolean | — |
DiffedControl
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
title requis | string | — |
domain requis | string | — |
criticality requis | string | — |
ModifiedControl
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
title requis | string | — |
changes requis | FieldDiff[] | — |
FieldDiff
| Champ | Type | Contraintes |
|---|---|---|
field requis | string | — |
fromValue requis | string | — |
toValue requis | string | — |
OverrideConflict
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
overriddenField requis | string | — |
tenantOverrideValue requis | string | — |
masterFromValue requis | string | — |
masterToValue requis | string | — |
DiffedQuestion
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
question requis | string | — |
domain requis | string | — |
ModifiedQuestion
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
questionText requis | string | — |
changes requis | FieldDiff[] | — |
DiffedTemplate
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
title requis | string | — |
category requis | string | null | — |
ModifiedTemplate
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
title requis | string | — |
changes requis | FieldDiff[] | — |
PendingUpgradeCount
| Champ | Type | Contraintes |
|---|---|---|
count requis | integer | — |
Mise à jour : 10 octobre 2026. Signaler une inexactitude