Aller au contenu
Aureus PrimeDocs

Référence API

Authentification

Chaque appel porte votre clé d'API dans l'en-tête Authorization :

Authorization: Bearer adk_sms_VOTRE_CLE

Sans clé, ou avec une clé révoquée : 401 AUTH_REQUIRED. Compte suspendu : 403 ACCOUNT_SUSPENDED.

Vos clés

  • Une clé est rattachée à votre compte SMS : elle ne voit et ne dépense que vos crédits.
  • Elle est affichée une seule fois, à sa création. Aureus Desk n'en garde qu'une empreinte : impossible de la retrouver ensuite.
  • Vous pouvez avoir 2 clés actives au plus. Une troisième création est refusée (409 API_KEY_LIMIT).

Changer de clé sans coupure

  1. Créez une deuxième clé.
  2. Déployez-la sur vos serveurs.
  3. Révoquez l'ancienne dans l'espace Compte.

Bonnes règles

  • Gardez la clé côté serveur : jamais dans une application mobile, une page web ou un dépôt de code.
  • Une clé exposée doit être révoquée tout de suite : les envois faits avec elle vous sont imputés.