Démarrage

Trois minutes : une clé, un appel, une réponse.

1. Créez une clé API

Un propriétaire ou un administrateur ouvre Développeur → Clés API dans l'application, nomme la clé et coche ses permissions. La clé s'affiche une seule fois ; ensuite seuls ses premiers caractères sont listés, et elle peut être révoquée à tout moment.

2. Appelez /v1/users/me

curl https://api.a1merica.ai/v1/users/me \
  -H "Authorization: Bearer aim_live_3f9c1e2d0a7b4c5d6e8f90123456789a"

{
  "id": "9d8c7b6a-1f2e-4d3c-8b9a-0e1f2a3b4c5d",
  "email": "alex@example.com",
  "name": "Alex Roy",
  "extension": "101",
  "role": "owner",
  "status": "active",
  "presence": {"status": "available", "dnd": false},
  "created_at": "2026-08-01T12:00:00Z"
}

La clé agit comme la personne qui l'a créée : elle voit ses lignes, les lignes partagées et celles de l'entreprise, jamais la ligne privée d'un collègue. Créez-la donc en tant que la personne dont l'intégration doit suivre les lignes.

3. Lisez les appels

curl "https://api.a1merica.ai/v1/calls?limit=2&direction=inbound" \
  -H "Authorization: Bearer aim_live_…"

{
  "items": [
    {
      "id": "6b1f0d2a-7e0c-4f1a-9c3a-1d2e3f4a5b6c",
      "direction": "inbound",
      "result": "answered",
      "from": {"number": "+15145550100", "name": "Marie Tremblay", "user_id": null},
      "to":   {"number": "+16135550101", "name": "Front desk", "user_id": "9d8c…"},
      "started_at": "2026-09-24T14:02:11Z",
      "answered_at": "2026-09-24T14:02:19Z",
      "ended_at": "2026-09-24T14:05:40Z",
      "duration_s": 201,
      "user_id": "9d8c…",
      "number_id": "c4e1…",
      "recording": {"id": "6b1f…", "available": true},
      "transcript_available": false,
      "ai": null,
      "updated_at": "2026-09-24T14:05:41Z"
    }
  ],
  "next_cursor": "eyJ…",
  "sync_token": "eyJzaW5jZSI6…"
}

Les listes se parcourent avec limit (1–200) et cursor ; sync_token ramène ensuite seulement ce qui a changé — voir Jetons de synchronisation.

Conventions

• Adresse de base : https://api.a1merica.ai/v1. Tout est JSON en UTF-8.
• Les horodatages sont ISO 8601 en UTC et se terminent par _at ; les durées en secondes par _s ; les montants en cents par _cents.
• Les numéros de téléphone sont au format E.164 (+15145550100) ; les identifiants sont des UUID sous forme de chaînes.
• Toute erreur a la même enveloppe — voir Erreurs. Chaque réponse porte un X-Request-Id : joignez-le à toute question.