Exemples
Recettes curl, Python et JavaScript prêtes-à-copier, sur l'API v2.
Remplacez arc_pat_VOTRE_TOKEN par votre PAT (cf. Authentification).
Ces exemples visaient /api/v1 jusqu'au 2026-10-09. La v1 a été retirée
de l'API publique : avec un jeton d'API, ses chemins répondent désormais
404. Tout ce qui suit est en v2. La correspondance complète est dans
la référence.
1. Lister les applications
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
https://api.arch-platform.com/api/v2/applicationsimport requests
resp = requests.get(
"https://api.arch-platform.com/api/v2/applications",
headers={"Authorization": "Bearer arc_pat_VOTRE_TOKEN"},
)
page = resp.json()
for app in page["items"]:
print(app["applicationId"], app["code"], app["name"])const resp = await fetch(
"https://api.arch-platform.com/api/v2/applications",
{ headers: { Authorization: "Bearer arc_pat_VOTRE_TOKEN" } },
);
const page = await resp.json();
console.log(page.items.length, "sur", page.page.totalItems);La réponse est une enveloppe, plus un tableau JSON nu :
{ items, page: { limit, nextCursor, previousCursor, totalItems } }.
page.totalItems est le total de l'ensemble filtré, pas la taille de la
page.
2. Parcourir toutes les pages
import requests
BASE = "https://api.arch-platform.com/api/v2"
AUTH = {"Authorization": "Bearer arc_pat_VOTRE_TOKEN"}
curseur, tout = None, []
while True:
params = {"limit": 200}
if curseur:
params["cursor"] = curseur
page = requests.get(f"{BASE}/applications", headers=AUTH, params=params).json()
tout += page["items"]
curseur = page["page"]["nextCursor"]
if not curseur:
break
print(len(tout))Repassez nextCursor tel quel, sans le construire vous-même : c'est une
valeur opaque. Et limit doit tenir entre 1 et 200 — hors bornes, la
réponse est 400, jamais une page silencieusement rognée.
3. Détail d'une application
⚠️ L'identifiant a changé. La v1 adressait une application par son code
métier (DEMO-CRM). La v2 utilise un applicationId — un UUID stable, que le
code ne garantit pas : un code peut être renommé, l'URL non.
Il n'existe pas de correspondance publique code → UUID : lisez-le dans la liste.
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
"https://api.arch-platform.com/api/v2/applications?q=DEMO-CRM" \
| jq -r '.items[0].applicationId'curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
https://api.arch-platform.com/api/v2/applications/3f2a1c8e-0000-4000-8000-000000000001Le détail groupe les 52 champs plats de la v1 en sept sous-objets :
hosting, lifecycle, compliance, assessment, costs, contacts,
sync. La liste, elle, rend un résumé de onze champs.
4. Filtrer les applications
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
"https://api.arch-platform.com/api/v2/applications?status=LIVE&criticality=MISSION_CRITICAL"Une valeur de filtre inconnue est refusée en 400, et le corps nomme
les valeurs admises. Attention à status : la valeur est LIVE, pas
ACTIVE.
5. Arbre des fonctions métier
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
https://api.arch-platform.com/api/v2/business-functions/treeL'ancien /referentiel/functions/posi devient un paramètre :
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
"https://api.arch-platform.com/api/v2/business-functions/tree?include=applications"6. KPIs référentiel
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
https://api.arch-platform.com/api/v2/business-functions/statisticsPatterns production
- Retry exponentiel sur
429(respectRetry-After) - Rotation token au démarrage si
401 - Timeout HTTP 30s (p99 < 2s pour les arbres)
- Paginez toujours : repassez
nextCursorjusqu'à ce qu'il soitnull. Lire seulement la première page donne au plus 200 éléments sans le dire —page.totalItemsvous apprend ce qui manque.