Changelog
Évolutions de l'API publique — Keep a Changelog.
Politique de versioning : une version majeure reste stable. Tout breaking change crée un nouveau préfixe, et la version précédente est servie 6 mois en parallèle.
⚠️ La v1 a été retirée le 2026-10-09 SANS cette période de 6 mois.
Elle n'avait aucun intégrateur — vérifié avant de décider. Les six mois existent pour laisser le temps de migrer ; il n'y avait personne à qui le laisser. L'engagement ci-dessus vaut pour la v2 et les suivantes ; la v1 en est une exception datée, pas un précédent.
v0.31.0 — 2026-10-09
-
⚠️ Rupture de comportement : sur
GET /api/v1/referentiel/applications, une valeur inconnue pourstatus,data_class,criticalityouregulationrend désormais400au lieu d'être ignorée.Jusqu'ici,
?status=ACTIVE— une valeur plausible, mais absente de l'énumération, qui ditLIVE— était silencieusement abandonnée et la réponse rendait200avec toutes les applications. Un appelant croyait lire une liste filtrée et lisait le référentiel entier, sans aucun moyen de s'en apercevoir.C'est une rupture assumée sur
/api/v1, par exception à la politique de versioning énoncée en haut de cette page : créer un/api/v3pour cesser de mentir n'aurait servi personne, et laisser le piège en place le temps d'une migration aurait laissé des intégrations rendre des résultats faux. Les valeurs admises sont nommées dans le corps de l'erreur.La tolérance de forme reste acquise : la casse est indifférente et le tiret vaut le souligné, donc
?criticality=mission-criticalfonctionne toujours. Seule la valeur inconnue change de traitement. -
Correction : un
PATCHouPUTau mauvaisContent-Type, un en-tête obligatoire absent, un paramètre au mauvais type (?limit=abc) rendaient500. Ils rendent maintenant415,400et400. Six exceptions de protocole HTTP tombaient dans le filet d'erreur générique ; un500disait « le serveur est en panne » là où il fallait lire « votre requête est mal formée ». -
⚠️ Retrait : la couche
/api/v1n'est plus exposée à l'API publique. Ses 15 endpoints répondent404à un jeton personnel ou partenaire. Ils existent toujours — ils servent l'interface web — mais ne font plus partie du contrat public.Pourquoi : l'API publique n'avait aucune existence propre. Les mêmes méthodes, les mêmes chemins et les mêmes DTO servaient l'interface ET les intégrateurs ; toute évolution de l'interface devenait une rupture de contrat public, et l'inverse. La v2 a ses propres représentations et peut évoluer séparément.
Correspondance complète :
Ancien chemin v1 Équivalent v2 /referentiel/applications/applications/referentiel/applications/{code}/applications/{applicationId}— ⚠️ UUID/referentiel/functions/business-functions/tree/referentiel/functions/posi/business-functions/tree?include=applications/referentiel/functions/flat/business-functions/referentiel/functions/search/business-functions?q=/referentiel/functions/by-application/{code}/business-functions?applicationCode=/referentiel/functions/stats/business-functions/statistics/referentiel/functions/{id}/business-functions/{functionId}/tenant/invitations(GET, POST)identique en v2, 201+Locationsur la création/tenant/invitations/{id}(DELETE)POST /tenant/invitations/{invitationId}/revoke/tenant/invitations/members/tenant/members/tenant/invitations/members/{userSub}/role(PATCH)PATCH /tenant/members/{memberId}/tenant/invitations/members/{userSub}(DELETE)DELETE /tenant/members/{memberId}Le document OpenAPI
public(v1) a disparu avec elle : l'explorateur du portail sert désormais la spec v2. ⚠️ Les SDKs TypeScript et Python visent la v1 et ne fonctionnent donc plus — voir SDKs. -
Ajout : couche v2 —
GET/PATCH/DELETEsur/api/v2/tenant/members. Les membres ont leur propre racine (ils vivaient sous/tenant/invitations/members) et une identité propre :memberId, un UUID stable, à la place dusubOIDC. ⚠️ Deux ruptures côté v2 : l'identifiant change, et un membre n'apparaît plus qu'une fois —rolesest un tableau, là où la v1 rendait une ligne par rôle accordé. Détails : /developer/reference.
v0.1.87 — 2026-07-01
Sprint AppService v2 — refonte du modèle applicatif pour couvrir les besoins RFP RSSI / Compliance (DORA, NIS2, RGPD). Additive N-1 compat : chaque champ ajouté a un défaut sensible, aucun caller v0.1.86 n'est cassé. Détails architecture : docs/APPSERVICE_V2_ARCHITECTURE.md.
- Ajout : Champ
dataClassificationsurApplication(enumPUBLIC/INTERNAL/CONFIDENTIAL/RESTRICTED, défautINTERNAL). Exposé surGET /api/v1/referentiel/applications/{code}+ accepté enPUT. Nouveau filtre?data_class=CONFIDENTIALsur la liste. Migration Liquibase 089. - Ajout : Champs
criticality(enum 4 niveauxMISSION_CRITICAL/IMPORTANT/NOMINAL/LOW) +rtoHours+rpoHourssurApplication. Backfill :applicationVip=true → MISSION_CRITICAL, elseNOMINAL. Nouveau filtre?criticality=. Migration Liquibase 090. - Ajout : Champ
regulationssurApplication— CSV multi-valeur (DORA,NIS2,RGPD,PCI_DSS,HDS,ISO_27001). Validation typée côté domain (token inconnu → 400). Nouveau filtre?regulation=DORA. Migration Liquibase 091. - Ajout : TCO éclaté — champs
licenseCost/supportCost/infraCost/staffCost(BIGINT nullable, minor units cents). Backfill legacyannual_cost → license_cost_cents. Le getterannualCostest maintenant dérivé (somme des 4 si ≥ 1 renseignée, sinon fallback legacy). Migration Liquibase 092. - Ajout : Champ
roleAssignmentssurApplication— CSV multi-valeur M:N au formatROLE:contact,ROLE:contact. 6 rôles typés :PRODUCT_OWNER,BUSINESS_OWNER,TECH_LEAD,ARCHITECT,SECURITY_OFFICER,DATA_OWNER. Backfill :contact_it → TECH_LEAD,contact_metier → PRODUCT_OWNER. Migration Liquibase 093. - Ajout (INTERNE — hors API publique) : Endpoint
/referentiel/applications/{code}/changes?limit=50— audit trail des changements sur les 11 fields whitelistés (criticité, RTO/RPO, classification donnée, réglementations, rôles assignés, coût TCO, statut). Ordre reverse-chronological, hard-cap 200. Alimente le tab Historique de la Fact Sheet. Migration Liquibase 094 (tableapplication_change_log). ⚠️ Cet endpoint n'est PAS exposé à l'API publique : il n'a pas d'annotation@PublicApi, et un appel avec un jeton d'API reçoit404. Il alimente l'onglet Historique de l'interface. Mentionné ici par erreur dans un changelog qui ne documente que la surface publique — corrigé le 2026-10-09. - Deprecation :
applicationVip(bool),annualCost(montant unique),contactITetcontactMetier(mono-valué) sont marqués@Deprecated(forRemoval=true)+ log WARN dans les setters. DROP planifié v0.1.88 — mettre à jour les callers legacy avant.
v0.1.77.1 — 2026-06-25
- Ajout : Webhooks sortants signés
POSTHTTP par subscription tenant. Catalogue V1 :application.created,application.updated,das.submitted. SignatureX-Arch-SignatureHMAC-SHA256 (formattimestamp.body), 4 headers de traçabilité (X-Arch-Timestamp,X-Arch-Event,X-Arch-Event-Id,X-Arch-Delivery-Id). Backoff exponentiel facteur 5 (1 min → 5 min → 25 min → 2 h → 10 h → 50 h, 6 tentatives max). Auto-disable de la subscription après 10 échecs consécutifs. CRUD via/admin/webhookscôté UI. Détails : /developer/webhooks. - Ajout : Spec OpenAPI enrichi de
x-codeSamples(curl / Python / JavaScript) sur tous les endpoints@PublicApi— exemples affichés dans le panneau Scalar côté /developer/explore.
v0.1.77 — 2026-06-24
- Ajout : Header
X-RateLimit-Reset(epoch secondes UTC) sur toutes les réponses/api/**, succès ou 429. Permet de pacer proactivement les requêtes sans attendre un 429.Retry-Afteraligné sur le même calcul. - Ajout : Réponses
401 Unauthorized(PAT invalide / expiré) et429 Too Many Requests(rate-limited) systématiquement documentées dans le spec OpenAPI — avec exemple JSON et headers associés. - Ajout : Tags
scope:read/scope:writeinjectés automatiquement dans la doc OpenAPI à partir de@PublicApi.scope. Plus besoin de chercher quel scope un endpoint exige.
v0.1.71 — 2026-06-24
- Ajout : SDK officiels TypeScript (
@arch-platform/sdk, npm) et Python (arch-platform-sdk, PyPI). Typage complet généré depuis le spec OpenAPI, auth PAT + OAuth2 supportées, sémantique identique entre les deux. Détails : /developer/sdks.
v0.1.70 — 2026-06-23
- Ajout : Endpoints provisioning utilisateurs
@PublicApisur/api/v1/tenant/invitations—POST /(invite),GET /(liste invitations),GET /members(membres actifs),DELETE /{id}(révoque invitation),DELETE /members/{userSub}(retire un membre). Permet d'automatiser l'offboarding RH via script. Scopesread/write. Détails : /developer/provisioning.
v0.1.67 — 2026-06-23
- Ajout : Référence API interactive Scalar sur /developer/explore — test des endpoints sans installer de client (Bearer PAT persisté en
localStorage).
v0.1.65 — 2026-06-22
- Ajout : Workflow self-service PAT — un dev dépose une demande justifiée sur /api-token-requests, un tenant-admin approuve et transmet le token via canal sécurisé.
- Ajout : OAuth2 Client Credentials pour partenaires long-terme — convention
client_id = arch-partner-<slug>, quota 600 req/min (3× PAT), TTL access token 5 min. - Ajout : Métriques Micrometer
arch.public_api.callsexposées via OTLP (par endpoint + statut).
v0.1.31 — 2026-05-26
- Ajout : API publique v1 — premiers endpoints
@PublicApisur/api/v1/referentiel/applicationset/api/v1/referentiel/functions. - Ajout : Authentification Personal Access Token (PAT, format
arc_pat_…). Rate limit 180 req/min par token.
Roadmap publique
- Endpoints
POST/PATCHsur/das(v0.2) - Formulaire self-service pour les demandes OAuth2 partenaires (v0.1.81+)
- Élargissement du catalogue d'events webhooks (
flux.created,notice.signed, etc. — V2)