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.
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 HTTP | POST |
| URL de l’API | https://smm.guide/api/v2 |
| Corps | application/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éponse | JSON, toujours avec HTTP 200, y compris pour un corps illisible ou une requête trop volumineuse. Une erreur est {"error": "…"} |
| Argent | Dollars 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ètre | Description |
|---|---|
key | Votre clé API |
action | services |
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ètre | Description |
|---|---|
key | Votre clé API |
action | add |
service | L’ID de la route, huit chiffres |
link | Lien vers la page, la publication ou le profil |
quantity | Quantité 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ètre | Description |
|---|---|
key | Votre clé API |
action | status |
order | ID de commande |
Réponse
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Paramètre | Description |
|---|---|
key | Votre clé API |
action | status |
orders | ID 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" }
}| Statut | Signification |
|---|---|
Pending | Accepté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, Processing | Un fournisseur la livre, ou la commande est en route vers l’étape suivante. |
Completed | Livrée en totalité. |
Partial | Livré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é. |
Canceled | Rien 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ètre | Description |
|---|---|
key | Votre clé API |
action | balance |
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ètre | Description |
|---|---|
key | Votre clé API |
action | cancel |
orders | ID 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ètre | Description |
|---|---|
key | Votre clé API |
action | refill |
order | ID 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ètre | Description |
|---|---|
key | Votre clé API |
action | refill_status |
refill | ID 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
| Erreur | Signification |
|---|---|
Invalid API key | La 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 request | Inconnu action. |
Incorrect service ID | Aucune de vos routes n’a cet ID. Une route supprimée conserve son numéro, qui n’est jamais attribué à une autre. |
Incorrect order ID | Aucune de vos commandes ne porte ce numéro. |
Link is required, Quantity is required | L’un des champs add est manquant ou n’est pas un nombre. |
A route takes a link and a quantity only | La requête contenait du drip-feed, des commentaires ou un autre champ supplémentaire. |
This route is switched off | Activez-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
statusappel. - 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.