Journal des changements

Ce qui change dans l'API, daté. Nous n'enlevons rien de v1 sans un préavis ici.

2026-11-07 — Les réglages de toute l'entreprise demandent un propriétaire ou un administrateur

Les abonnements webhook (/v1/webhooks, toutes les routes) sont réservés au propriétaire ou à un administrateur de l'entreprise, comme dans l'application : un jeton d'utilisateur ou une clé API doit avoir un propriétaire ou un administrateur actif derrière lui (l'application de l'entreprise elle-même aussi). Chaque filtre demande sa permission de lecture (recordings.ready demande recordings:read, une permission sensible) ; sinon 403 insufficient_scope.
GET/PUT /v1/browser-phone/origins : propriétaire ou administrateur de l'entreprise (ou l'application de l'entreprise) ; un changement est inscrit au journal de l'entreprise, comme dans l'application.
POST /v1/browser-phone/sessions : la session d'une autre personne demande un propriétaire ou un administrateur derrière l'identifiant (une clé API agit comme la personne qui l'a créée), et seul le propriétaire peut en ouvrir une sur la ligne du propriétaire ; l'application de l'entreprise n'ouvre la ligne du propriétaire que si c'est le propriétaire qui l'a enregistrée.

Un composeur dans votre page enregistre une ligne par wss://a1merica.ai/sip-ws et transporte l'audio (WebRTC) ; pour la plateforme c'est un téléphone sur la ligne. Voir Téléphone navigateur.
Routes POST/DELETE /v1/browser-phone/sessions, GET /v1/browser-phone/ice, GET/PUT /v1/browser-phone/origins ; permissions phone:browser et phone:manage (non sensibles).
Une session dure jusqu'à ce que vous la révoquiez, sauf durée demandée (ttl_hours, 1 h à un an) ; nous ne révoquons jamais ce que vous avez configuré.
Dans l'application : Développeur → Téléphone navigateur (adresses Web autorisées, mots de passe d'appareil, les étapes).

Nouvel hôte https://api.a1merica.ai/v1 avec des formes publiques stables : users, numbers, devices, calls (dont contrôle d'appel en cours), recordings, transcripts, presence, messages, conversations, voicemails, faxes, webhooks, account.
OAuth 2.0 : code d'autorisation + PKCE, identifiants client, renouvellement avec rotation, révocation, introspection. Apps enregistrées dans Développeur → Apps ; permissions sensibles sur approbation pour les apps tierces.
Vingt-et-une permissions (table) ; les clés existantes gardent leurs noms et sont acceptées par v1.
Webhooks de deuxième génération : poignée de main à la création, filtres par famille, expiration renouvelable, suspension après 20 échecs, test.ping, journal des livraisons. Même signature qu'avant.
Pagination par curseur, jetons de synchronisation, paliers de débit avec en-têtes, enveloppe d'erreur unique, X-Request-Id.
Bac à sable par app : une entreprise de démonstration jamais facturée, réinitialisable, avec sa clé.
Ce site, et la référence générée depuis /v1/openapi.json.

Clés aim_live_… avec sept permissions sur l'API de l'application (/voip/api) ; 60 requêtes par minute par clé.
Webhooks sortants signés (X-AIMERICA-Signature: t=…,v1=…) pour neuf événements, et Slack.