Tutoriel vidéo, 5 min 35

Tutoriel API SMM panel : utiliser l'API pas à pas, en vidéo

Vidéo en français, avec chapitres et sous-titres sur YouTube · English tutorial · Kiswahili

L'API de Jeskie Panel relie votre site, votre app ou votre SMM panel à nos services. Votre logiciel envoie une requête POST avec votre clé API et une action (services, add, status ou balance), et le panel répond en JSON. Ce tutoriel suit la vidéo chapitre par chapitre : la clé API, les quatre actions, votre marge, une commande du début à la fin, le code prêt à l'emploi et la connexion de votre SMM panel à un provider.

Ce que fait l'API d'un SMM panel

Une API de SMM panel permet à un logiciel de passer des commandes, de suivre leur statut et de lire votre solde sans que personne ne clique sur le site. Au lieu de copier le lien d'un client dans le panel à la main, votre site envoie la commande dès que le client a payé, et la livraison démarre toute seule.

Ce que vous pouvez construire avec une API SMM

  • Un site de reseller : vos clients vous paient, et chaque commande part automatiquement vers Jeskie Panel.
  • Votre propre SMM panel, avec Jeskie Panel comme provider pour les followers, likes et views.
  • Un bot WhatsApp ou Telegram, ou une app mobile, qui vend des services dans une conversation.
  • Un tableau de bord d'agence qui passe beaucoup de commandes par jour pour ses clients.

L'API est gratuite : chaque compte Jeskie Panel a sa clé, et vous payez seulement les commandes passées, depuis votre solde, au même prix que sur le site. Vous commandez seulement pour vos propres pages ? Le site et l'app Jeskie SMM sont plus simples pour vous.

Comment utiliser l'API d'un SMM panel en 5 étapes

  1. Créez un compte et copiez votre clé API. Inscrivez-vous sur la page d'inscription, ouvrez la page Compte et copiez votre clé API. C'est la partie 1 de la vidéo, à 0:49.
  2. Récupérez la liste des services. Envoyez action=services : la réponse donne chaque service actif avec son ID, son nom, son type, sa catégorie, son prix (rate), son minimum et son maximum.
  3. Choisissez les services que vous vendez. Enregistrez leurs ID dans votre base de données, à côté de votre prix de vente. Actualisez la liste à heure fixe, pas à chaque visite.
  4. Passez une commande. Envoyez action=add avec l'ID du service, le lien public du client et la quantité. Le panel répond avec un ID de commande : gardez-le avec la commande de votre client.
  5. Suivez la commande. Envoyez action=status avec l'ID de commande et affichez le statut à votre client. Vérifiez action=balance avant les grosses commandes, pour qu'aucune n'échoue faute de solde.

Tout passe par un seul endpoint POST, /api/v2 sur Jeskie Panel, avec des champs de formulaire et des réponses JSON. Tout langage capable d'envoyer une requête HTTP fonctionne : PHP, Python, Node.js, ou un outil no-code qui appelle un webhook.

Authentification : votre clé API dans chaque requête

L'authentification de l'API Jeskie Panel tient en un seul champ : envoyez votre clé dans le paramètre key de chaque requête, à côté du paramètre action. Il n'y a ni token séparé, ni étape OAuth, ni connexion préalable. Une clé absente ou fausse renvoie {"error": "Invalid API Key."}.

  • Gardez la clé sur votre serveur, dans un fichier de configuration ou une variable d'environnement.
  • Ne la mettez jamais dans une page web, un dépôt de code public ou une app que les utilisateurs téléchargent : quiconque a la clé peut dépenser votre solde.
  • Si elle fuit un jour, générez-en une nouvelle sur la page Compte et remplacez-la partout où elle est enregistrée.

Les quatre actions de l'API : services, add, status, balance

La partie 2 de la vidéo, à 1:30, présente ces quatre actions. Chacune est un POST vers le même endpoint ; seuls les champs changent.

ActionChamps à envoyerCe que vous recevez
serviceskey, actionChaque service actif : ID, nom, type, catégorie, rate, min, max
addkey, action, service, link, quantityUn ID de commande
add en drip feedles champs de add, plus runs et intervalUn ID de commande
statuskey, action, ordercharge, start_count, status, remains, currency
balancekey, actionVotre solde et sa monnaie

Les paramètres de add selon le type de service

Le champ type de la liste des services vous dit quels paramètres envoyer avec add :

TypeParamètres de add
Defaultservice, link, quantity ; runs et interval en option pour le drip feed
Packageservice, link (taille fixe, sans quantity)
Custom Commentsservice, link, comments (un commentaire par ligne)

En drip feed sur un service Default, le total livré est runs multiplié par quantity, avec interval minutes entre deux runs. Le refill et l'annulation ne sont pas encore des actions de l'API : pour un refill, appuyez sur Refill sur la commande dans votre compte, pendant la période de refill du service.

Requête et réponse : à quoi ressemble le JSON

Une requête est un POST classique, avec un corps encodé en application/x-www-form-urlencoded. Après un add réussi, vous recevez l'ID de la commande :

{"order": 23501}

Un status sur cette commande renvoie par exemple :

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

charge est le montant débité, start_count le compteur au départ de la livraison, et remains la quantité non livrée, déjà remboursée sur votre solde quand le statut est Partial.

Pourquoi l'API peut répondre HTTP 200 avec une erreur

Dans le format SMM panel v2, que suivent la plupart des panels, un refus (solde trop bas, mauvais ID de service, lien manquant) est écrit dans le corps JSON, dans un champ error, par exemple {"error": "Incorrect Service ID."}. Le code HTTP seul ne dit donc pas si la commande est passée. La bonne habitude : lisez toujours la réponse, cherchez error, et seulement ensuite lisez order ou balance.

Votre marge sur chaque commande

Le rate de la liste des services est votre coût pour 1 000 unités, dans la monnaie de base du panel, avec le prix spécial de votre compte déjà appliqué. Vous fixez votre propre prix de vente pour 1 000. Si le rate est R et que vous vendez à V, une commande de 2 000 vous coûte 2 x R sur votre solde, vous la facturez 2 x V à votre client, et la différence est à vous.

Jeskie Panel est un provider direct : aucune marge d'un autre panel n'est cachée dans R, ce qui vous laisse de la place pour un bon prix et une vraie marge. Comparez votre prix au rate du jour à chaque actualisation de la liste. Les prix du jour en FCFA, en francs congolais et en francs guinéens sont sur la page prix du SMM panel en FCFA.

Une commande du début à la fin

  1. Votre client choisit un service sur votre site, colle un lien public et vous paie.
  2. Votre serveur envoie action=add avec l'ID du service, le lien et la quantité.
  3. Jeskie Panel répond avec un ID de commande ; vous l'enregistrez à côté de la commande du client.
  4. Votre serveur envoie action=status toutes les quelques minutes et affiche le statut sur votre site.
  5. À Completed, la commande est terminée. À Partial ou Canceled, vous remboursez à votre client la partie non livrée, que Jeskie Panel a déjà remise sur votre solde.

Code prêt à l'emploi : PHP, cURL et Python

La vidéo montre ce code à 3:37. Remplacez YOUR_API_KEY par votre clé et l'ID de service par un ID de la liste. Chaque exemple passe une commande ; changez l'action en services, status ou balance pour les autres appels.

PHP

function jeskie_api(array $fields) {
  $ch = curl_init("https://jeskieinc.com/api/v2");
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(["key" => "YOUR_API_KEY"] + $fields),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
  ]);
  $reply = json_decode(curl_exec($ch), true);
  curl_close($ch);
  return $reply;
}

$new = jeskie_api(["action" => "add", "service" => 1,
  "link" => "https://instagram.com/votreprofil", "quantity" => 1000]);
if (isset($new["error"])) { echo "Commande refusee : " . $new["error"]; }
else { echo "ID de commande : " . $new["order"]; }

cURL

API=https://jeskieinc.com/api/v2
curl -X POST "$API" -d "key=YOUR_API_KEY" -d "action=balance"
curl -X POST "$API" -d "key=YOUR_API_KEY" -d "action=add" \
  -d "service=1" -d "link=https://instagram.com/votreprofil" -d "quantity=1000"
curl -X POST "$API" -d "key=YOUR_API_KEY" -d "action=status" -d "order=23501"

Python

import requests

API_URL = "https://jeskieinc.com/api/v2"
API_KEY = "YOUR_API_KEY"

def jeskie_api(**fields):
    reply = requests.post(API_URL, data={"key": API_KEY, **fields}, timeout=30)
    return reply.json()

print(jeskie_api(action="balance"))
order = jeskie_api(action="add", service=1,
                   link="https://instagram.com/votreprofil", quantity=1000)
if "error" in order:
    print("Commande refusee :", order["error"])
else:
    print(jeskie_api(action="status", order=order["order"]))

Un client PHP complet est aussi disponible en fichier d'exemple sur la documentation de l'API SMM panel, avec chaque paramètre et chaque réponse. Un bot ou un panel en Node.js, en Go ou dans un autre langage suit le même schéma : un POST encodé en formulaire, puis la lecture du JSON.

Suivre le statut d'une ou de plusieurs commandes

StatutSignificationCe que votre site affiche
PendingReçue, en attente de démarrage« Votre commande est dans la file »
In progressLa livraison a commencé« Livraison commencée »
ProcessingEn cours de traitement« Livraison en cours »
CompletedQuantité complète livrée« Terminé », avec le lien de la publication
PartialLivrée en partie, le reste remboursé sur votre soldeRembourser la partie non livrée au client
CanceledAnnulée et remboursée sur votre soldeRembourser le client en entier

Sur Jeskie Panel, l'action status prend un ID de commande par appel. Pour suivre beaucoup de commandes, gardez la liste de celles qui ne sont pas terminées, vérifiez-les toutes les quelques minutes, et retirez une commande de la liste dès qu'elle est Completed, Partial ou Canceled. Comparez les statuts sans tenir compte des majuscules.

Il n'y a pas de limite stricte de requêtes, mais une boucle serrée ne sert à rien : gardez la liste des services en cache, actualisez-la une fois par jour, et espacez vos appels status. Votre intégration reste rapide et fiable.

Les erreurs de l'API et comment les corriger

Chaque erreur arrive en JSON avec un champ error. Les messages restent en anglais, tels que votre code les reçoit :

Message d'erreurCauseSolution
Invalid API Key.La clé n'est pas reconnueRecopiez-la depuis la page Compte, sans espace
Incorrect request.Le champ action ou key manqueEnvoyez les deux à chaque appel
Incorrect Service ID.L'ID de service est vide ou fauxPrenez un ID de l'action services
Link field is required.Aucun lien envoyéEnvoyez le lien public
Quantité sous le min ou au-dessus du maxLa quantité sort des limites du serviceRestez entre le min et le max du service
You don't have sufficient balance to place this order.Solde trop basRechargez, puis renvoyez la commande
You cannot start a new order with the same link that is already in progress.Une commande est déjà en cours sur ce lienAttendez la fin, ou utilisez un autre lien
Incorrect order IDID de commande introuvableVérifiez l'ID enregistré

Les pièges qui coûtent de l'argent

  • Une clé exposée. Quiconque a votre clé peut dépenser votre solde : gardez-la côté serveur.
  • Des prix périmés. Les rates peuvent changer. Une liste gardée des semaines en cache peut vous faire vendre sous votre coût : actualisez-la chaque jour.
  • Des erreurs ignorées. Traitez chaque réponse qui n'est pas un ID de commande et affichez un message clair au client au lieu d'encaisser sans livrer.
  • Deux commandes sur un même lien. Attendez la fin de la première avant d'en envoyer une autre pour le même service.
  • Des remboursements oubliés. Repassez à vos clients les montants Partial et Canceled que Jeskie Panel vous a rendus : les tickets de support restent rares.

Connecter votre SMM panel à Jeskie Panel comme provider

Si vous avez déjà un script de SMM panel, vous n'écrivez presque pas de code. C'est la partie 3 de la vidéo, à 4:17. La plupart des scripts ont une page de réglages providers ou API où l'on ajoute un provider avec deux valeurs : l'adresse de l'API et votre clé.

  1. Ajoutez un petit solde. Sur Add Funds, rechargez avec Orange Money, Wave, MTN MoMo, Moov Money, une carte ou Binance Pay.
  2. Ajoutez Jeskie Panel comme provider. Saisissez l'URL d'API des exemples de code ci-dessus (elle finit par /api/v2) et votre clé API.
  3. Importez les services et fixez vos prix. Choisissez les services à vendre et votre prix de vente sur chacun.
  4. Testez comme un client. Passez une petite commande sur un lien qui vous appartient et vérifiez qu'elle apparaît dans votre historique Jeskie Panel avec le bon lien et la bonne quantité.
  5. Ouvrez le service à vos clients. Commencez par une petite commande, voyez la vitesse de livraison, puis ouvrez les autres services.

Pas de script ? Ouvrez un child panel depuis votre compte, ou louez chez Jeskie Rental un panel prêt, avec les services de Jeskie Panel déjà reliés, votre domaine et des paiements locaux encaissés pour vous. Pour faire de la revente un vrai business, lisez devenir reseller SMM en Afrique.

Pourquoi les resellers en Afrique construisent sur Jeskie Panel

  • Des prix de provider direct. Nos propres serveurs de livraison, aucun panel entre vous et le service : votre marge reste à vous.
  • Des recharges locales. Votre solde accepte le mobile money dans plus de 25 pays africains, donc pas besoin d'une carte en dollars pour payer vos commandes API.
  • Un historique vérifiable. Plus de 500 000 commandes livrées depuis juin 2021, avec une note de 4,9/5.
  • Le format qu'attend votre panel. Un endpoint, quatre actions, des réponses JSON : la plupart des logiciels de panel se connectent avec une URL et une clé.

Vos clients sont en Côte d'Ivoire, au Sénégal, au Cameroun ou en RD Congo ? Le SMM panel pour l'Afrique francophone donne les moyens de paiement pays par pays.

Réponses

Questions fréquentes sur l'API SMM panel

Comment utiliser l'API d'un SMM panel ?

+
Copiez votre clé API, envoyez action=services pour voir les ID de services, envoyez action=add avec un ID de service, un lien public et une quantité, puis action=status avec l'ID de commande. La vidéo montre chaque étape en un peu plus de cinq minutes.

Comment obtenir ma clé API Jeskie Panel ?

+
Connectez-vous, ouvrez la page Compte et copiez votre clé API. Gardez-la sur votre serveur et générez-en une nouvelle sur la même page si elle fuit un jour.

Comment fonctionne l'authentification de l'API ?

+
Par un seul champ : votre clé, envoyée dans le paramètre key de chaque requête POST, avec le paramètre action. Il n'y a ni token séparé ni OAuth. Une clé absente ou fausse renvoie Invalid API Key.

Pourquoi l'API peut répondre HTTP 200 avec une erreur ?

+
Dans le format SMM panel v2, le refus est écrit dans le corps JSON, dans un champ error, et non dans le code HTTP. Lisez donc toujours la réponse et cherchez error avant de lire order ou balance.

Peut-on suivre le statut de plusieurs commandes à la fois ?

+
Sur Jeskie Panel, l'action status prend un ID de commande par appel. Gardez la liste de vos commandes non terminées, vérifiez-les toutes les quelques minutes et retirez-les dès qu'elles sont Completed, Partial ou Canceled.

L'API SMM panel est-elle gratuite ?

+
Oui. Chaque compte Jeskie Panel a sa clé API, sans frais d'installation ni abonnement. Vous payez seulement les commandes passées, depuis votre solde, au même prix que sur le site.

Quel langage faut-il pour utiliser l'API ?

+
N'importe quel langage qui envoie une requête HTTP POST : PHP, Python, Node.js et d'autres. Cette page donne des exemples prêts en PHP, cURL et Python, et beaucoup de scripts de SMM panel se connectent sans code.

Comment connecter mon SMM panel à Jeskie Panel ?

+
Dans les réglages providers ou API de votre panel, ajoutez un provider avec l'URL d'API de Jeskie Panel et votre clé, importez les services, fixez vos prix, puis passez une petite commande de test.

Peut-on demander un refill ou annuler une commande par l'API ?

+
Pas encore : l'API prend les actions services, add, status et balance. Pour un refill, appuyez sur Refill sur la commande dans votre compte pendant la période de refill. Pour le reste, écrivez au support avec l'ID de commande.

Que se passe-t-il si une commande est Partial ?

+
Une partie seulement a été livrée et Jeskie Panel rembourse automatiquement la partie non livrée sur votre solde. La réponse status donne remains : remboursez la même part à votre client.

Comment créer mon propre SMM panel ?

+
Installez un script de SMM panel et ajoutez Jeskie Panel comme provider par l'API, ouvrez un child panel depuis votre compte Jeskie Panel, ou louez un panel prêt chez Jeskie Rental, avec les services déjà reliés.

Comment payer les commandes passées par l'API ?

+
Elles sont débitées de votre solde Jeskie Panel. Rechargez sur Add Funds avec Orange Money, Wave, MTN MoMo, Moov Money, une carte ou Binance Pay. Les prix du jour en FCFA sont sur prix du SMM panel.

Quel provider propose une API SMM panel en Afrique ?

+
Jeskie Panel, provider direct basé à Nairobi depuis juin 2021, donne une API gratuite à chaque compte, avec des recharges par mobile money dans plus de 25 pays africains et des prix sans marge d'un autre panel.

Votre première commande par API aujourd'hui

Créez votre compte, rechargez par mobile money et copiez votre clé sur la page Compte. Commencez par une petite commande, voyez la vitesse de livraison, puis laissez votre site ou votre panel commander tout seul.

Aller plus loin

Pour aller plus loin avec l'API