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.
https://izyboost.com/api/v2Authentification & 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éthode | Emplacement | Description |
|---|---|---|
key | Corps de la requête (Body) | Votre clé API secrète (ex: izy_live_9a87d6...) |
Authorization | En-tête HTTP (Header) | Bearer VOTRE_CLE_API |
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.
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.
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
}
]2. Passer une nouvelle commande
Débite automatiquement votre solde de compte et injecte la commande dans notre file d'exécution Cloud.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
action | string | Oui | Valeur fixe : "add" |
service | number | Oui | Identifiant numérique du service (obtenu via action: "services") |
link | string | Oui | Lien public complet de la publication ou du compte cible |
quantity | number | Oui* | Quantité souhaitée (*déduite automatiquement du nombre de lignes si comments est fourni) |
comments | string | Requis si type Custom Comments | Commentaires personnalisés séparés par des retours à la ligne (\n). Chaque ligne représente un commentaire individuel. |
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
}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ètre | Type | Description |
|---|---|---|
order | number | ID de la commande unique à vérifier |
orders | string | IDs multiples séparés par une virgule (ex: 1420,1421,1422) |
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"
}4. Consulter le solde du compte API
Permet de surveiller votre crédit disponible avant de déclencher des commandes programmées.
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 HTTP | Message d'erreur type | Cause & 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.