AIMERICAAPI · Développeurs

Journal des changements

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

2026-09-25 — API v1.0

  • 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.

2026-09-24 — Clés API et webhooks (première génération)

  • 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.

À venir

  • Recherche, commande et portage de numéros par l'API ; une app Zapier ; des SDK.