Exemples de code :

Documentation API Développeur

L'API IzyBoost vous permet d'intégrer directement notre passerelle de diffusion d'engagement sur vos propres applications, sites web, bots Telegram ou panneaux revendeurs tiers.

URL de base de l'API (Endpoint unique v2)
https://izyboost.com/api/v2

Authentification & Sécurité

Toutes les requêtes adressées à l'API doivent inclure votre clé secrète de production. Vous pouvez la transmettre de deux manières :

MéthodeEmplacementDescription
keyCorps de la requête (Body)Votre clé API secrète (ex: izy_live_9a87d6...)
AuthorizationEn-tête HTTP (Header)Bearer VOTRE_CLE_API
Important : Ne partagez jamais votre clé API dans du code public (ex: GitHub) ni dans du JavaScript exécuté côté client. Toutes les requêtes doivent transiter par votre serveur backend.

Format des Requêtes & Réponses

Notre passerelle supporte les deux formats de communication standards :

  • JSON : Content-Type: application/json (recommandé pour Node.js, Python, Go).
  • Form-URL-Encoded : Content-Type: application/x-www-form-urlencoded (standard pour les scripts PHP et les panneaux SMM Revendeurs).

Toutes les réponses sont renvoyées au format JSON avec les codes de statut HTTP correspondants.


POSTaction: "services"

1. Lister les services et tarifs en temps réel

Renvoie l'intégralité des services disponibles sur la plateforme, leurs identifiants, catégories, taux au millier (en USD), et limites minimales et maximales.

Requête (CURL)
curl -X POST https://izyboost.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{
    "key": "VOTRE_CLE_API_SECRETE",
    "action": "services"
  }'

Exemple de réponse JSON (200 OK) :

[
  {
    "service": 101,
    "name": "TikTok Vues Rapides Haute Rétention",
    "type": "Default",
    "category": "TikTok - Vues",
    "rate": "0.1500",
    "min": 500,
    "max": 5000000,
    "refill": true,
    "cancel": false
  },
  {
    "service": 204,
    "name": "Instagram Followers Actifs Profils Réels",
    "type": "Default",
    "category": "Instagram - Followers",
    "rate": "1.2000",
    "min": 100,
    "max": 100000,
    "refill": true,
    "cancel": true
  }
]

POSTaction: "add"

2. Passer une nouvelle commande

Débite automatiquement votre solde de compte et injecte la commande dans notre file d'exécution Cloud.

ParamètreTypeRequisDescription
actionstringOuiValeur fixe : "add"
servicenumberOuiIdentifiant numérique du service (obtenu via action: "services")
linkstringOuiLien public complet de la publication ou du compte cible
quantitynumberOui*Quantité souhaitée (*déduite automatiquement du nombre de lignes si comments est fourni)
commentsstringRequis si type Custom CommentsCommentaires personnalisés séparés par des retours à la ligne (\n). Chaque ligne représente un commentaire individuel.
Requête (CURL)
curl -X POST https://izyboost.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{
    "key": "VOTRE_CLE_API_SECRETE",
    "action": "add",
    "service": 101,
    "link": "https://www.tiktok.com/@creator/video/123456789",
    "quantity": 1000
  }'

Exemple de réponse JSON (200 OK) :

{
  "order": 1420
}

POSTaction: "status"

3. Consulter l'état d'avancement d'une commande

Permet de suivre le statut, le compteur initial, le nombre restant à livrer et le coût débité.

ParamètreTypeDescription
ordernumberID de la commande unique à vérifier
ordersstringIDs multiples séparés par une virgule (ex: 1420,1421,1422)
Requête (CURL)
curl -X POST https://izyboost.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{
    "key": "VOTRE_CLE_API_SECRETE",
    "action": "status",
    "order": 1420
  }'

Exemple de réponse JSON (200 OK) :

{
  "charge": "0.1500",
  "start_count": "4520",
  "status": "In progress",
  "remains": "250",
  "currency": "USD"
}

POSTaction: "balance"

4. Consulter le solde du compte API

Permet de surveiller votre crédit disponible avant de déclencher des commandes programmées.

Requête (CURL)
curl -X POST https://izyboost.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{
    "key": "VOTRE_CLE_API_SECRETE",
    "action": "balance"
  }'

Exemple de réponse JSON (200 OK) :

{
  "balance": "145.8200",
  "currency": "USD"
}

Codes d'Erreur & Réponses Types

Code HTTPMessage d'erreur typeCause & Solution
401 Unauthorized"Clé API invalide ou révoquée."Vérifiez que votre clé est active sur votre tableau de bord.
402 Payment Required"Solde insuffisant pour exécuter cette commande."Rechargez votre compte en Mobile Money, Carte ou Crypto.
400 Bad Request"Quantité invalide. Min: X, Max: Y."Ajustez la quantité demandée aux paliers autorisés.
404 Not Found"Service introuvable ou actuellement indisponible."Vérifiez l'ID du service via l'action services.

Prêt à automatiser vos commandes ?

Générez votre clé API personnelle en un clic et démarrez l'intégration.

Accéder au Gestionnaire de Clés API →