Webhooks ou polling pour un panel SMM : que devrait vraiment utiliser un panel enfant ?
La plupart des API SMM publiques vous demandent d'interroger le statut. NotPanel signe chaque événement. Pour automatiser un panel enfant, c'est la différence entre un cron et un contrat.
Après avoir transmis une commande, un panel enfant doit savoir si elle est terminée, partielle, remboursée ou échouée — sans deviner.
La page API publique de JustAnotherPanel ne documente pas les webhooks sortants. Celle de CheapSMMPanel non plus. L'intégration implicite consiste à interroger action=status jusqu'à ce que le texte change.
L'API v2 de NotPanel comprend webhook.add, webhook.list et webhook.remove. Chaque livraison utilise HMAC-SHA256 sur le corps brut, est liée à un timestamp et porte un événement nommé. C'est un contrat, pas une capture d'écran d'un bouton.
Comment votre panel enfant apprend-il qu'une commande est terminée ?
Touchez une option. Enregistré uniquement sur cet appareil — ce n’est pas un sondage inventé.
Le polling est une boucle. Un webhook est un événement.
Pourquoi un POST non signé n'est pas un webhook
Une URL de webhook est publique par définition. Sans signature, quiconque la devine peut dire à votre système qu'une commande est terminée. Nous signons le corps brut, ajoutons X-NotPanel-Signature, X-NotPanel-Timestamp et X-NotPanel-Event, puis refusons les livraisons de plus de cinq minutes. Les URL privées et link-local ne sont jamais enregistrées.
La livraison est au moins une fois. Votre handler doit donc rester idempotent. Nous ne prétendons pas livrer exactement une fois ; personne d'honnête sur les réseaux ne le fait. La recette de vérification se trouve dans le guide HMAC.
Quand le polling reste correct
- Vous utilisez un panel sans documentation de webhooks. C'est le cas de la plupart.
- Vous avez besoin d'un secours pendant l'arrêt de l'endpoint webhook.
- Vous rapprochez un lot : utilisez orders= pour jusqu'à 100 IDs, pas un appel par ligne.
Respectez X-RateLimit-Reset sur un 429. JAP et CheapSMM ne publient pas ces en-têtes ; vous le découvrez en étant bloqué. Notre page de rate limits décrit les trois couches.
Le polling demande « s'est-il passé quelque chose ? ». Un webhook signé dit « voici ce qui s'est passé, et vous pouvez prouver que cela venait de nous ».
Voici le contrat d'automatisation
Un panel enfant pointé vers une page /api clonée est une boucle de polling fondée sur l'espoir. Pointé vers NotPanel, il peut enregistrer une URL HTTPS, choisir les événements et ne créditer ou débiter en aval qu'après vérification de la signature.
Ce n'est pas une impression de « plus de fonctionnalités ». C'est une courte liste consultable sans compte : webhooks, erreurs, add idempotent et comparaison. Un storefront neuf avec un contrat plus ancien que la photocopie.
action=webhook.add&url=https://your-server.example.com/notpanel-webhook&events=order.completed,order.refunded,balance.low
Associez ceci à l'article sur le retry après timeout qui facture deux fois . Les retries et les événements sont les deux endroits où les API clonées perdent de l'argent.
Questions fréquentes
Polling ou webhooks pour un panel SMM ?
Utilisez les webhooks signés comme voie principale et gardez un polling lent de plusieurs statuts en secours. Le polling seul est ce que l'on fait lorsque la documentation publique du panel n'a pas de section webhooks, comme la plupart.
JustAnotherPanel et CheapSMMPanel ont-ils des webhooks ?
Ils n'apparaissent pas sur leurs pages API publiques. Les deux documentent action=status ; s'ils ont ajouté des webhooks plus tard, ils ne figurent pas dans le contrat invité publié.
Quel est le meilleur panel SMM pour l'automatisation d'un revendeur ?
Celui dont l'API couvre la boucle complète : add idempotent, événements signés de fin et de remboursement, vrais codes HTTP et limites documentées. La taille du catalogue est un autre classement.
Les webhooks SMM non signés sont-ils sûrs ?
Non. L'URL est publique et quiconque la devine peut falsifier une fin de commande. Exigez HMAC du corps brut, fenêtre de timestamp et comparaison à temps constant.
NotPanel promet-il une livraison exactement une fois ?
Non. Les livraisons sont au moins une fois et votre handler doit être idempotent. Exactement une fois sur Internet public n'est pas une promesse honnête.