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
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
  https://api.arch-platform.com/api/v2/applications
Python
import 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"])
JavaScript
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

Python
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 — étape 1 : trouver l'identifiant
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 — étape 2 : le détail
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
  https://api.arch-platform.com/api/v2/applications/3f2a1c8e-0000-4000-8000-000000000001

Le 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
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
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
  https://api.arch-platform.com/api/v2/business-functions/tree

L'ancien /referentiel/functions/posi devient un paramètre :

curl — avec les applications liées
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
curl -H "Authorization: Bearer arc_pat_VOTRE_TOKEN" \
  https://api.arch-platform.com/api/v2/business-functions/statistics

Patterns production

  • Retry exponentiel sur 429 (respect Retry-After)
  • Rotation token au démarrage si 401
  • Timeout HTTP 30s (p99 < 2s pour les arbres)
  • Paginez toujours : repassez nextCursor jusqu'à ce qu'il soit null. Lire seulement la première page donne au plus 200 éléments sans le dire — page.totalItems vous apprend ce qui manque.

On this page