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
Breaking change → nouveau préfixe /v2 + 6 mois de coexistence.
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 /api/v1/... ne bouge pas. Tout breaking change ouvre un nouveau préfixe /api/v2/... avec 6 mois de coexistence, notifications email 30 jours en amont. Suivi détaillé : changelog API.
Rate limits — 180 req/min en PAT, 600 req/min en OAuth2 partenaire. Détails : /developer/rate-limits.