Documentazione API
Una handler_api compatibile con sms-activate: stesse azioni, stati, codici di paese e servizio, più un webhook dei codici.
URL handler_api
https://allinsms.com/stubs/handler_api.php
Base REST API
https://allinsms.com/v1
Numeri (handler_api)
GET o POST con api_key e action. I paesi usano gli id numerici standard (getCountries) e i servizi i codici standard (tg, wa, go …). Le risposte sono in testo semplice, salvo diversa indicazione.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | Parametri | Risposta | Descrizione |
|---|---|---|---|
| getBalance | Nessuno | ACCESS_BALANCE:12.3400 | Credito attuale in USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | Acquista un numero. Addebito immediato, rimborso se non arriva alcun codice. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | Come getNumber, risposta JSON con prezzo e ora di fine. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | Interroga ogni 3 a 5 secondi finché non arriva un codice. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | Stato JSON con il testo completo dell'SMS. |
| getFullSms | id | FULL_SMS:Your code is 48213 | Testo completo dell'ultimo SMS. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 pronto, 3 altro codice, 6 completa, 8 annulla (dopo il tempo di attesa, prima di un codice). |
| getActiveActivations | Nessuno | {"status":"success","activeActivations":[…]} | I tuoi numeri ancora attivi. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | Prezzo e disponibilità per paese e servizio. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | Disponibilità per servizio in un paese. |
| getCountries | Nessuno | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | Elenco dei paesi con id. |
| getServicesList | Nessuno | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | Codici e nomi dei servizi. |
Valori di setStatus
- 1 · Numero inviato al servizio, in attesa dell'SMS
- 3 · Richiedi un altro codice sullo stesso numero
- 6 · Completa l'attivazione
- 8 · Annulla e rimborsa (ancora nessun codice)
Tempistiche
I numeri sono attivi per 20 minuti di default. L'annullamento è accettato 120 secondi dopo l'acquisto (prima restituisce EARLY_CANCEL_DENIED). Senza codice, l'attivazione viene rimborsata automaticamente alla scadenza. Limite di frequenza: 300 richieste al minuto per chiave.
Errori
Webhook
Imposta un URL webhook in Account e inviamo con POST ogni codice ricevuto in formato JSON, con due nuovi tentativi se il tuo server non risponde 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" }