Démarrage — API REST¶

Ce guide vous fait passer de zéro à votre premier appel authentifié. La référence technique complète (auth, idempotence, webhooks, endpoints) est en anglais, à partir de Quickstart.

Base API (DEV)

https://dev.aeliam.ai/api/v1/public (en production : https://app.aeliam.ai/api/v1/public — voir Environnements).

1. Obtenir une clé API¶

Connectez-vous sur https://dev.aeliam.ai.
Allez dans Clés API (/cabinet/api-keys).
Nouvelle clé → donnez un nom (ex. « Intégration n8n »), choisissez l'environnement et cochez les droits (commencez par crm:read + devis:read).
Copiez immédiatement la clé (aelm_dev_…) — elle ne sera plus jamais affichée.

Une clé est un secret

Ne committez jamais une clé dans un dépôt git, ne l'exposez pas côté navigateur. Stockez-la dans un gestionnaire de secrets ou une variable d'environnement. Révoquez sans attendre toute clé suspectée compromise.

2. Premier appel¶

Vérifiez votre authentification avec l'endpoint d'introspection /me :

curl -H "X-API-Key: aelm_dev_xxxxxxxx" \
     https://dev.aeliam.ai/api/v1/public/me

Réponse (200) :

{
  "key_id": "00000000-0000-0000-0000-000000000000",
  "cabinet_id": "11111111-1111-1111-1111-111111111111",
  "scopes": ["crm:read", "devis:read"],
  "environment": "dev",
  "rate_limit": { "limit": 1000, "remaining": 999, "reset_at_ts": 1779993600 }
}

Vous pouvez aussi passer la clé via Authorization: Bearer aelm_dev_xxxxxxxx — les deux sont acceptés.

3. Et ensuite¶

Tout le détail développeur (curl, Python, JavaScript, n8n) : Quickstart (EN)
Authentification & droits : Authentication (EN)
Idempotence & quotas (création, tarification) : Idempotency & quotas (EN)
Webhooks (événements sortants signés) : Webhooks (EN)
Référence exhaustive des endpoints (toujours à jour) : API Reference

Le flux phare : tarification automatisée¶

L'enchaînement typique pour obtenir un tarif assureur depuis votre intégration :

GET /produits-disponibles/{code}/schema?compagnie=axa — connaître les champs requis.
POST /clients — créer le contact (optionnel).
POST /devis — créer un brouillon (sans rien lancer).
POST /automation/tarifications — déclencher la tarification réelle (RPA).
GET /automation/jobs/{job_id} — suivre le job jusqu'à completed.
GET /devis/{devis_id}/pdf — récupérer le PDF.

Détaillé côté technique dans le Quickstart.