Panel SMM API : documentation

Qu'est-ce que l'API d'un panel SMM ?

L'API d'un panel SMM permet à un programme de récupérer la liste des services, de passer des commandes et de consulter le statut des commandes et le solde sans passer par le site. 4SNS PLUS prend en charge le format standard d'API v2 pour panels SMM utilisé par de nombreux panels et bots : le code déjà connecté à un autre panel fonctionne aussitôt en changeant simplement l'URL et la clé.

Les prix et le solde de l'API sont les mêmes que sur le site. Le rate de la réponse services correspond au prix pour 1,000 (dollars américains) de la liste de prix, et les commandes passées avec add sont débitées de votre solde exactement comme les commandes web et apparaissent aussi dans l'historique des commandes de votre espace. Les montants rendus par les commandes annulées ou partielles reviennent sur ce même solde.

L'essentiel

Exemple de requête

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

Comment obtenir une clé API ?

Dès que votre première recharge est créditée sur votre solde, vous pouvez créer une clé API depuis le menu Clé API de votre espace. La clé ne s'affiche qu'une seule fois à sa création : conservez-la en lieu sûr. Créer une nouvelle clé désactive immédiatement la précédente.

La clé est distincte du jeton de votre compte. Mettez uniquement la clé API dans votre bot ou votre serveur, jamais le jeton du compte. Si vous pensez que votre clé a été exposée, créez-en simplement une nouvelle sur l'écran Clé API.

Liste des services (services)

Renvoie tous les services que vous pouvez commander. rate est le prix pour 1,000 (USD) et, lorsque type vaut Package, le prix d'un pack. Lorsque type vaut Custom Comments, vous envoyez une liste de commentaires au lieu d'une quantité. category est le nom de la plateforme suivi du nom du groupe.

Exemple de réponse

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

Passer une commande (add)

Passe une commande et débite le montant de votre solde. Le montant est le prix pour 1,000 multiplié par la quantité ; pour Package c'est le prix du pack, et pour Custom Comments le nombre de lignes de commentaires fait office de quantité. Les commandes sont possibles sur les comptes dont la première recharge est créditée. Le champ order de la réponse est l'ID de votre commande.

Exemple de réponse

{
  "order": 31877
}

Statut d'une commande (status)

Le statut d'une commande. charge est le montant réellement payé après remboursements (USD, 6 décimales), start_count le compteur au démarrage de la commande et remains la quantité pas encore livrée.

Exemple de réponse

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Statut de plusieurs commandes (status, orders)

Vérifie jusqu'à 100 commandes à la fois, avec les ID de commande séparés par des virgules. Les ID inexistants ou qui n'appartiennent pas à votre compte reçoivent une erreur à leur place.

Exemple de réponse

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Demander un remplacement (refill)

Pour la commande d'un service avec période de remplacement terminée en Completed ou Partial, faites la demande pendant la période de remplacement comptée à partir de la fin. Chaque commande peut avoir une demande ouverte, avec 24 heures entre deux demandes.

Exemple de réponse

{
  "refill": 512
}

Statut du remplacement (refill_status)

Le statut d'une demande de remplacement.

Exemple de réponse

{
  "status": "Completed"
}

Solde (balance)

Votre solde (USD, 6 décimales).

Exemple de réponse

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

Valeurs de statut des commandes

Valeurs de statut du remplacement

Messages d'erreur

Les erreurs arrivent en JSON avec un champ error dans une réponse HTTP 200. Dans votre code, vérifiez d'abord le champ error.

{
  "error": "Not enough funds on balance"
}

Comment connecter l'API d'un panel SMM à un bot Telegram ?