Dokumentasyon ng API
handler_api na compatible sa sms-activate: parehong mga action, status, country at service code, at may code webhook pa.
URL ng handler_api
https://allinsms.com/stubs/handler_api.php
Base ng REST API
https://allinsms.com/v1
Mga numero (handler_api)
GET o POST gamit ang api_key at action. Gumagamit ang mga bansa ng karaniwang numeric id (getCountries) at ang mga serbisyo ng karaniwang code (tg, wa, go …). Plain text ang mga sagot maliban kung nakasaad.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | Mga parameter | Sagot | Paglalarawan |
|---|---|---|---|
| getBalance | Wala | ACCESS_BALANCE:12.3400 | Kasalukuyang credit sa USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | Bumili ng numero. Agad sinisingil, nire-refund kapag walang code. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | Katulad ng getNumber, JSON na sagot na may presyo at oras ng pagtatapos. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | Mag-poll bawat 3 hanggang 5 segundo hanggang dumating ang code. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | JSON na status kasama ang buong teksto ng SMS. |
| getFullSms | id | FULL_SMS:Your code is 48213 | Buong teksto ng huling SMS. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 handa, 3 isa pang code, 6 tapusin, 8 kanselahin (pagkatapos ng paghihintay, bago ang code). |
| getActiveActivations | Wala | {"status":"success","activeActivations":[…]} | Ang mga numero mong aktibo pa. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | Presyo at stock ayon sa bansa at serbisyo. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | Stock bawat serbisyo para sa isang bansa. |
| getCountries | Wala | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | Listahan ng bansa kasama ang id. |
| getServicesList | Wala | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | Mga service code at pangalan. |
Mga value ng setStatus
- 1 · Naipadala ang numero sa serbisyo, naghihintay ng SMS
- 3 · Humiling ng isa pang code sa parehong numero
- 6 · Tapusin ang activation
- 8 · Kanselahin at i-refund (wala pang code)
Oras
Aktibo ang mga numero nang 20 minuto bilang default. Tinatanggap ang kansela 120 segundo pagkatapos bumili (mas maaga ay magbabalik ng EARLY_CANCEL_DENIED). Kapag walang code, awtomatikong nire-refund ang activation pagtatapos nito. Rate limit: 300 request bawat minuto bawat key.
Mga error
Webhook
Maglagay ng webhook URL sa Account at ipo-POST namin dito ang bawat natanggap na code bilang JSON, uulitin nang dalawang beses kung hindi sumagot ng 2xx ang iyong server.
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" }