Accueil / Développeurs / Orders API

Orders API

Ajoutez smm.guide à votre panel comme fournisseur. Chaque route que vous créez dans votre compte est un service avec son propre ID : votre panel envoie une commande à cet ID, et la route la transmet au premier de vos fournisseurs capable de la prendre.

Trois étapes

Le format est celui que les panels SMM utilisent déjà entre eux : il n’y a rien à programmer.

1Créez une routeCompte, Orders desk, Routes. Choisissez ce qu’elle livre et ajoutez jusqu’à cinq services de ce type issus des panels que vous avez connectés.
2Créez la cléOrders desk, Orders API. La clé ne s’affiche qu’une fois. Vous pouvez la limiter à l’adresse du serveur de votre panel.
3Ajoutez un fournisseur dans votre panelURL de l’API https://smm.guide/api/v2 et la clé. Importez les services : vos routes arrivent avec leurs ID, prix et limites.

Format de requête

Méthode HTTPPOST
URL de l’APIhttps://smm.guide/api/v2
Corpsapplication/x-www-form-urlencoded, ou JSON avec Content-Type: application/json. A multipart/form-data est également accepté comme corps : c’est ce qu’envoie PHP lorsque cURL reçoit un tableau
RéponseJSON, toujours avec HTTP 200, y compris pour un corps illisible ou une requête trop volumineuse. Une erreur est {"error": "…"}
ArgentDollars américains. Les prix sont pour 1 000

Liste des services

Vos routes capables de prendre une commande en ce moment. Une route désactivée, ou dont toutes les étapes sont hors service, n’est pas listée.

ParamètreDescription
keyVotre clé API
actionservices

Réponse

[
  {
    "service": 85725095,
    "name": "TG views, main",
    "type": "Default",
    "category": "Telegram views",
    "rate": "0.0018",
    "min": "10",
    "max": "1000000",
    "refill": false,
    "cancel": true,
    "dripfeed": false
  }
]

rate correspond à l’étape la plus chère de la route susceptible de prendre une commande, y compris celles momentanément ignorées (un panel hors service aujourd’hui revient demain) : une commande ne coûte donc jamais plus que le prix importé par votre panel. min et max sont les plus larges couvertes par l’ensemble des étapes fonctionnelles ; une quantité qui ne convient qu’à certaines d’entre elles va à l’une de celles-ci. refill et cancel valent true lorsque toutes ces étapes les proposent.

Une route désactivée, ou sans aucune étape fonctionnelle, est exclue de cette liste jusqu’à son retour. Un panel qui synchronise automatiquement ses services désactivera ce service de son côté pendant la même durée, ce qui est souhaitable : ses commandes seraient refusées.

Ajouter une commande

ParamètreDescription
keyVotre clé API
actionadd
serviceL’ID de la route, huit chiffres
linkLien vers la page, la publication ou le profil
quantityQuantité souhaitée

Réponse

{
  "order": 23501
}

Aucun fournisseur ne l’a acceptée

{
  "error": "No step of this route accepted the order. …"
}

Le numéro de commande reste le même pendant toute la vie de la commande, quel que soit le fournisseur qui la livre finalement. Une route accepte un lien et une quantité ; le drip-feed, les commentaires et les autres champs supplémentaires sont refusés.

Statut de la commande

ParamètreDescription
keyVotre clé API
actionstatus
orderID de commande

Réponse

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParamètreDescription
keyVotre clé API
actionstatus
ordersID de commande séparés par une virgule, 100 maximum

Réponse

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatutSignification
PendingAcceptée par un fournisseur et pas encore démarrée. Également une commande pour laquelle un fournisseur n’a pas donné de réponse claire : la route s’arrête là jusqu’à ce que vous l’ayez vérifiée dans votre compte.
In progress, ProcessingUn fournisseur la livre, ou la commande est en route vers l’étape suivante.
CompletedLivrée en totalité.
PartialLivrée en partie ; remains correspond à ce qui ne l’a pas été. Il tient compte de ce que chaque étape a livré : lorsqu’une étape a livré une partie et que le reste a été annulé à l’étape suivante, la commande est Partielle, et non Annulée. Le fournisseur décide du remboursement du reste du montant débité.
CanceledRien n’a été livré, et aucune autre étape n’a pris la commande. charge indique ce qui, le cas échéant, est resté débité.

charge correspond à ce que les fournisseurs ont facturé pour cette commande, en dollars au taux du jour où elle a été passée. start_count provient du fournisseur qui l’a démarrée.

Solde

smm.guide ne détient aucun argent vous appartenant. Le chiffre est la somme de vos soldes sur les panels derrière vos routes, en dollars.

ParamètreDescription
keyVotre clé API
actionbalance

Réponse

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

Annuler

Transmise au fournisseur qui détient actuellement la commande, si son service propose l’annulation. Une commande que vous annulez n’est jamais transmise à l’étape suivante.

ParamètreDescription
keyVotre clé API
actioncancel
ordersID de commande séparés par une virgule, 100 maximum

Réponse

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Refill

Transmis au fournisseur qui a livré la commande. Le refill porte le numéro propre de la commande.

ParamètreDescription
keyVotre clé API
actionrefill
orderID de commande. Ou orders : plusieurs, séparés par une virgule

Réponse, une commande

{ "refill": "23501" }

Réponse, plusieurs

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParamètreDescription
keyVotre clé API
actionrefill_status
refillID du refill. Ou refills : plusieurs, séparés par une virgule

Réponse

{ "status": "Completed" }

Ce qu’une route fait d’une commande

  • Les étapes sont essayées dans votre ordre, ou la moins chère disponible en premier. Vous choisissez dans la route.
  • Une étape est ignorée lorsque son panel ne répond pas, que son solde ou sa limite quotidienne ne couvre pas la commande, que la quantité sort de ce qu’il accepte, que son prix dépasse la limite que vous avez fixée, ou qu’à ce prix la commande dépasserait la limite quotidienne de la route. Elle revient d’elle-même.
  • Une étape est retirée lorsque son service disparaît de la liste de prix, ou que le panel se met à vendre autre chose sous le même ID. Les autres étapes continuent de fonctionner, et vous êtes prévenu.
  • Un refus fait passer la commande à l’étape suivante. Lorsqu’un panel répond par un refus, rien n’a été débité : l’étape suivante est donc essayée.
  • Une réponse floue l’arrête. Un délai dépassé ou une réponse illisible ne dit pas si la commande existe. La transmettre pourrait entraîner une double livraison et un double débit : la route s’arrête donc et vous vérifiez cette commande dans votre compte.
  • Une seule commande en cours par lien. Tant qu’une commande pour un lien est en cours sur une route, une seconde pour le même lien est refusée, comme le font les fournisseurs eux-mêmes.
  • Une annulation avant livraison peut aussi passer à l’étape suivante, si vous avez activé cette option. Ce qu’une commande partielle n’a pas livré ne passe à l’étape suivante que si vous l’avez demandé.

Erreurs

ErreurSignification
Invalid API keyLa clé est erronée, remplacée ou révoquée.
This key is limited to certain addresses…La requête provient d’une adresse qui ne figure pas dans la liste de la clé.
Incorrect requestInconnu action.
Incorrect service IDAucune de vos routes n’a cet ID. Une route supprimée conserve son numéro, qui n’est jamais attribué à une autre.
Incorrect order IDAucune de vos commandes ne porte ce numéro.
Link is required, Quantity is requiredL’un des champs add est manquant ou n’est pas un nombre.
A route takes a link and a quantity onlyLa requête contenait du drip-feed, des commentaires ou un autre champ supplémentaire.
This route is switched offActivez-la dans votre compte.
This route already has an order for this link…Attendez que celle en cours soit terminée.
No step of this route can take this order right now. …Toutes les étapes ont été ignorées avant tout envoi. Le texte indique chaque panel et son motif.
No step of this route accepted the order. …Toutes les étapes sollicitées ont refusé. Rien n’a été débité.
Too many requests…Limite ci-dessous dépassée. Patientez une minute.

Exemples

cURL

curl https://smm.guide/api/v2 \
  -d key=sgo_… \
  -d action=add \
  -d service=85725095 \
  -d link=https://t.me/channel/123 \
  -d quantity=1000

PHP

function smmguide(array $post) {
  $ch = curl_init('https://smm.guide/api/v2');
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(
      ['key' => 'sgo_…'] + $post),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
  ]);
  $out = json_decode(curl_exec($ch), true);
  curl_close($ch);
  return $out;
}
$order = smmguide(['action' => 'add',
  'service' => 85725095,
  'link' => 'https://t.me/channel/123',
  'quantity' => 1000]);

Un appel add reçoit toujours une réponse en moins de 30 secondes. Une route peut solliciter plusieurs fournisseurs l’un après l’autre ; chacun dispose de ce qui reste de ce délai, et un fournisseur qu’on ne pourrait pas attendre n’est pas sollicité du tout. Si le dernier sollicité n’a pas répondu à l’expiration du délai, vous obtenez un numéro de commande avec le statut En attente, et la route s’arrête là jusqu’à ce que la réponse soit connue. La plupart des commandes reçoivent une réponse en une ou deux secondes.

Limites et sécurité

  • 300 requêtes par minute et par clé, dont 120 commandes. Jusqu’à 100 ID de commande en une status appel.
  • La clé ne s’affiche qu’une fois et est conservée sous forme d’empreinte. Ni vous ni nous ne pouvons la relire. La remplacer désactive immédiatement l’ancienne.
  • Adresses autorisées. Indiquez l’adresse du serveur de votre panel dans votre compte : la clé ne fonctionnera depuis nulle part ailleurs.
  • Un ID de route n’est pas un secret et n’a pas besoin de l’être. Il ne fonctionne qu’avec la clé du compte propriétaire de la route.
  • Vos limites s’appliquent toujours. La limite quotidienne de chaque panel, la limite quotidienne de la route et sa commande maximale s’appliquent aux commandes arrivant via l’API exactement comme à celles que vous passez à la main.
  • L’argent ne transite jamais par smm.guide. Chaque commande est payée depuis votre solde sur le panel qui la prend. Les remboursements et les litiges restent entre vous et ce panel.

Vous voulez plutôt lire le catalogue ?

Les panels, les Trust Scores et les prix en direct ont leur propre API, ainsi qu’un serveur MCP pour les assistants.