Skip to main content

​
Endpoints

MéthodeEndpointDescription
GET/api/v1/instancesLister les instances de votre compte
GET/api/v1/instances/{id}Détail d’une instance
GET/api/v1/instances/{id}/stateÉtat live depuis le provider
Authentification : x-api-key: <api_key>

​
Qu’est-ce qu’une instance ?

Une instance est un numéro WhatsApp connecté à MsgFlash. Vous créez et connectez les instances depuis le dashboard. L’API publique permet ensuite de lire leur détail et leur état live.

​
États possibles

StatutDescription
disconnectedInstance existante mais non connectée
connectingConnexion en cours
connectedInstance prête à envoyer

​
Lister les instances

curl https://srv.msgflash.com/api/v1/instances \
  -H "x-api-key: msgf_live_your_api_key_here"

​
Paramètres

Cette route n’accepte ni query params ni body.

​
Réponse succès

{
  "data": [
    {
      "id": "inst_uuid",
      "name": "boutique-principale",
      "waNumber": "+22912345678",
      "status": "connected",
      "webhook": null,
      "meta": null,
      "deletedAt": null,
      "createdAt": "2026-04-01T09:00:00.000Z",
      "updatedAt": "2026-04-01T09:10:00.000Z"
    }
  ]
}

​
Erreurs courantes

CodeHTTPQuand
UNAUTHORIZED401Clé API manquante ou invalide
API_RATE_LIMIT_EXCEEDED429Plus de 10 req/s sur la même clé

​
Détail d’une instance

curl https://srv.msgflash.com/api/v1/instances/INSTANCE_ID \
  -H "x-api-key: msgf_live_your_api_key_here"

​
Paramètres path

ParamètreTypeRequisDescription
idUUIDouiID de l’instance
{
  "data": {
    "id": "inst_uuid",
    "name": "boutique-principale",
    "waNumber": "+22912345678",
    "status": "connected",
    "createdAt": "2026-04-01T09:00:00.000Z",
    "updatedAt": "2026-04-01T09:10:00.000Z"
  }
}

​
Erreurs courantes

CodeHTTPQuand
NOT_FOUND404Instance inexistante ou hors de votre compte

​
État live

curl https://srv.msgflash.com/api/v1/instances/INSTANCE_ID/state \
  -H "x-api-key: msgf_live_your_api_key_here"

​
Paramètres path

ParamètreTypeRequisDescription
idUUIDouiID de l’instance
{
  "data": {
    "instanceId": "inst_uuid",
    "status": "connected",
    "providerState": "open"
  }
}

​
Erreurs courantes

CodeHTTPQuand
NOT_FOUND404Instance inexistante ou hors de votre compte