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 pour status, data_class, criticality ou regulation rend désormais 400 au lieu d'être ignorée.

    Jusqu'ici, ?status=ACTIVE — une valeur plausible, mais absente de l'énumération, qui dit LIVE — était silencieusement abandonnée et la réponse rendait 200 avec 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/v3 pour 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-critical fonctionne toujours. Seule la valeur inconnue change de traitement.

  • Correction : un PATCH ou PUT au mauvais Content-Type, un en-tête obligatoire absent, un paramètre au mauvais type (?limit=abc) rendaient 500. Ils rendent maintenant 415, 400 et 400. Six exceptions de protocole HTTP tombaient dans le filet d'erreur générique ; un 500 disait « le serveur est en panne » là où il fallait lire « votre requête est mal formée ».

  • ⚠️ Retrait : la couche /api/v1 n'est plus exposée à l'API publique. Ses 15 endpoints répondent 404 à 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 + Location sur 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/DELETE sur /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 du sub OIDC. ⚠️ Deux ruptures côté v2 : l'identifiant change, et un membre n'apparaît plus qu'une fois — roles est 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 dataClassification sur Application (enum PUBLIC / INTERNAL / CONFIDENTIAL / RESTRICTED, défaut INTERNAL). Exposé sur GET /api/v1/referentiel/applications/{code} + accepté en PUT. Nouveau filtre ?data_class=CONFIDENTIAL sur la liste. Migration Liquibase 089.
  • Ajout : Champs criticality (enum 4 niveaux MISSION_CRITICAL / IMPORTANT / NOMINAL / LOW) + rtoHours + rpoHours sur Application. Backfill : applicationVip=true → MISSION_CRITICAL, else NOMINAL. Nouveau filtre ?criticality=. Migration Liquibase 090.
  • Ajout : Champ regulations sur Application — 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 legacy annual_cost → license_cost_cents. Le getter annualCost est maintenant dérivé (somme des 4 si ≥ 1 renseignée, sinon fallback legacy). Migration Liquibase 092.
  • Ajout : Champ roleAssignments sur Application — CSV multi-valeur M:N au format ROLE: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 (table application_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çoit 404. 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), contactIT et contactMetier (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 POST HTTP par subscription tenant. Catalogue V1 : application.created, application.updated, das.submitted. Signature X-Arch-Signature HMAC-SHA256 (format timestamp.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/webhooks cô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-After aligné sur le même calcul.
  • Ajout : Réponses 401 Unauthorized (PAT invalide / expiré) et 429 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:write injecté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

v0.1.70 — 2026-06-23

  • Ajout : Endpoints provisioning utilisateurs @PublicApi sur /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. Scopes read / 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.calls exposées via OTLP (par endpoint + statut).

v0.1.31 — 2026-05-26

  • Ajout : API publique v1 — premiers endpoints @PublicApi sur /api/v1/referentiel/applications et /api/v1/referentiel/functions.
  • Ajout : Authentification Personal Access Token (PAT, format arc_pat_…). Rate limit 180 req/min par token.

Roadmap publique

  • Endpoints POST / PATCH sur /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)

On this page