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.
Démarrer en 3 étapes
1. Demander un token
PAT self-service. Approbation tenant-admin, transmission par canal sécurisé.
2. Explorer les endpoints
Liste complète des endpoints @PublicApi avec schémas et exemples live.
3. Coder l'intégration
Recettes prêtes à copier en curl, Python et JavaScript.
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
| Mode | Pour qui | Comment |
|---|---|---|
| Personal Access Token (/developer/auth) | Devs internes, scripts, CI, POC | Self-service via /api-token-requests, validé par l'admin tenant |
| OAuth2 Client Credentials (/developer/oauth2) | Partenaires SaaS, intégrations long-terme | Sur 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.