Documentation API
Une handler_api compatible sms-activate : mêmes actions, statuts, codes pays et codes services, avec en plus un webhook des codes.
URL handler_api
https://allinsms.com/stubs/handler_api.php
Base de l'API REST
https://allinsms.com/v1
Numéros (handler_api)
GET ou POST avec api_key et action. Les pays utilisent les identifiants numériques standard (getCountries) et les services les codes standard (tg, wa, go …). Les réponses sont en texte brut sauf mention contraire.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | Paramètres | Réponse | Description |
|---|---|---|---|
| getBalance | Aucun | ACCESS_BALANCE:12.3400 | Crédit actuel en USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | Acheter un numéro. Débité immédiatement, remboursé si aucun code n'arrive. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | Comme getNumber, réponse JSON avec le prix et l'heure de fin. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | Interrogez toutes les 3 à 5 secondes jusqu'à l'arrivée d'un code. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | Statut JSON avec le texte complet du SMS. |
| getFullSms | id | FULL_SMS:Your code is 48213 | Texte complet du dernier SMS. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 prêt, 3 autre code, 6 terminer, 8 annuler (après le délai d'attente, avant un code). |
| getActiveActivations | Aucun | {"status":"success","activeActivations":[…]} | Vos numéros encore actifs. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | Prix et stock par pays et par service. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | Stock par service pour un pays. |
| getCountries | Aucun | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | Liste des pays avec leurs identifiants. |
| getServicesList | Aucun | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | Codes et noms des services. |
Valeurs de setStatus
- 1 · Numéro envoyé au service, en attente du SMS
- 3 · Demander un autre code sur le même numéro
- 6 · Terminer l'activation
- 8 · Annuler et rembourser (pas encore de code)
Délais
Les numéros sont actifs 20 minutes par défaut. L'annulation est acceptée 120 secondes après l'achat (avant, la réponse est EARLY_CANCEL_DENIED). Sans code, l'activation est remboursée automatiquement à sa fin. Limite : 300 requêtes par minute et par clé.
Erreurs
Webhook
Définissez une URL de webhook dans Compte et nous y envoyons en POST chaque code reçu au format JSON, avec deux nouvelles tentatives si votre serveur ne répond pas 2xx.
POST https://your-server/webhook
{ "activationId": 1042, "service": "tg", "country": "id", "phone": "6281244739021",
"code": "48213", "text": "Telegram code: 48213 …", "receivedAt": "2026-10-09T03:12:44.000Z" }