API publique Architecture Platform

Intégrez le référentiel et la gouvernance d'architecture à vos outils internes — CMDB, dashboards, scripts d'audit, applications partenaires.

API stable · v1

https://api.arch-platform.com/api/v2

La v1 n'est plus exposée depuis le 2026-10-09.

Démarrer en 3 étapes

Cas d'usage typiques

  • Synchroniser une CMDB externe — pull/push ServiceNow ↔ ARB (référence : /developer/webhooks)
  • Alimenter un dashboard interne — Référentiel SI → Looker, Power BI, Metabase
  • Auditer la cohérence — règles cross-tenant, écarts de criticité, dette technique
  • Intégration partenaire — SaaS consommateur de la cartographie (catalogue logiciel, IT asset management)

Authentification — deux modes

ModePour quiComment
Personal Access Token (/developer/auth)Devs internes, scripts, CI, POCSelf-service via /api-token-requests, validé par l'admin tenant
OAuth2 Client Credentials (/developer/oauth2)Partenaires SaaS, intégrations long-termeSur demande à support@arch-platform.com (formulaire self-service prévu v0.1.81+)

Stabilité & versioning

L'URL d'une version majeure ne bouge pas. Tout breaking change ouvre un nouveau préfixe, et la version précédente reste servie 6 mois avec notification email 30 jours en amont. Suivi détaillé : changelog API.

Exception assumée : la v1 a été retirée sans cette période, le 2026-10-09.

Elle n'avait aucun intégrateur — vérifié avant de décider. Les six mois de coexistence existent pour laisser le temps de migrer ; il n'y avait personne à qui le laisser. Maintenir une surface publique que personne n'appelle, mais dont chaque évolution de notre interface web menaçait le contrat, n'aurait servi qu'à figer l'interface.

C'est écrit ici plutôt que passé sous silence : l'engagement ci-dessus vaut pour la v2 et les suivantes, et la v1 en est une exception datée, pas un précédent.

Rate limits — 180 req/min en PAT, 600 req/min en OAuth2 partenaire. Détails : /developer/rate-limits.

On this page