Authentification

Les deux surfaces

Surface	Méthode	Header	Usage
Dashboard	JWT Bearer	`Authorization: Bearer <jwt>`	Interface web et endpoints console `/api/*`
API publique	Clé API	`x-api-key: <api_key>`	Endpoints `/api/v1/*` pour vos intégrations serveur à serveur

Pour toute intégration serveur à serveur, utilisez une clé API.

La console web et l’API publique n’utilisent pas le même mode d’authentification.

Format de la clé API

Une clé API MsgFlash ressemble à :

msgf_live_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2

Structure :

préfixe msgf_live_
64 caractères hexadécimaux minuscules

La clé complète n’est affichée qu’une seule fois lors de la création.

Utiliser votre clé API

curl https://srv.msgflash.com/api/v1/messages/send \
  -H "x-api-key: msgf_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "instanceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "to": "+33612345000",
    "type": "text",
    "text": "Bonjour"
  }'

N’utilisez pas Authorization: Bearer <api_key> pour l’API publique. Le backend attend explicitement le header x-api-key.

Créer et révoquer une clé

Connectez-vous à app.msgflash.com
Ouvrez API Keys
Cliquez sur New API Key
Donnez un nom descriptif
Copiez la clé immédiatement

Pour révoquer une clé :

Retournez dans API Keys
Cliquez sur Revoke
Confirmez

La révocation est immédiate.

Authentification de la console

Pour la console web, les principaux flux sont :

inscription
connexion
OAuth Google
vérification e-mail
mot de passe oublié

Guide détaillé : Voir le guide d’authentification dashboard

Nombre de clés par plan

Plan	Clés API autorisées
Free	1
Starter	3
Pro	10
Plus	10

Bonnes pratiques

Une clé par environnement

Utilisez une clé distincte pour la production, le staging et le développement.

Variables d'environnement

Stockez votre clé dans une variable comme MSGFLASH_API_KEY ou dans un gestionnaire de secrets.

Erreurs liées à l’authentification

Code	HTTP	Description
`UNAUTHORIZED`	401	Clé manquante, invalide ou révoquée
`FORBIDDEN`	403	La clé est valide mais n’a pas accès à la ressource
`SUBSCRIPTION_INACTIVE`	403	Le compte n’a plus de souscription exploitable pour l’action demandée
`API_RATE_LIMIT_EXCEEDED`	429	Plus de 10 requêtes/seconde sur la même clé
`MONTHLY_API_REQUEST_QUOTA_EXCEEDED`	429	Quota mensuel de requêtes API épuisé

Exemple :

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or revoked API key"
  }
}

Concepts fondamentaux Authentification dashboard

Pour commencer

Guides

Référence API · Équipes

Référence API · Instances

Référence API · Messages

Référence API · Campagnes

Référence API · Modèles

Référence API · Contacts

Référence API · Groupes

Référence API · Number lookups

Référence API · Webhooks

Référence API · Facturation

Ressources

Les deux surfaces

Format de la clé API

Utiliser votre clé API

Créer et révoquer une clé

Authentification de la console

Nombre de clés par plan

Bonnes pratiques

Une clé par environnement

Variables d'environnement

Erreurs liées à l’authentification

​Les deux surfaces

​Format de la clé API

​Utiliser votre clé API

​Créer et révoquer une clé

​Authentification de la console

​Nombre de clés par plan

​Bonnes pratiques

Une clé par environnement

Variables d'environnement

​Erreurs liées à l’authentification

Les deux surfaces

Format de la clé API

Utiliser votre clé API

Créer et révoquer une clé

Authentification de la console

Nombre de clés par plan

Bonnes pratiques

Erreurs liées à l’authentification