Developer API
SMS verification direkta mula sa code mo
Isang HTTPS na tawag ang nagbibigay sa bot o platform mo ng totoong numero para sa WhatsApp, Telegram at marami pang serbisyo. Tanggapin ang code sa webhook o long polling at magbayad lang para sa mga numerong nakatanggap ng code.
- 2,281serbisyo
- 200bansa
- Awtomatikorefund kapag walang code
curl
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
-H "Authorization: Bearer $SMSGRAB_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"service":"whatsapp","country":"indonesia"}'
Python
activation = requests.post(
"https://smsgrab.com/api/dev/v1/activations",
headers={"Authorization": f"Bearer {key}", "Idempotency-Key": str(uuid.uuid4())},
json={"service": "whatsapp", "country": "indonesia"},
timeout=30,
).json()
Node.js
const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
method: 'POST',
headers: {
Authorization: `Bearer ${key}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());
PHP
$activation = json_decode((string) $client->post('activations', [
'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
'headers' => ['Idempotency-Key' => bin2hex(random_bytes(16))],
])->getBody(), true);
Go
order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation)
{
"id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
"compat_id": 100000123,
"status": "WAITING_SMS",
"service_id": "whatsapp",
"country_id": "indonesia",
"phone_number": "+6281234567890",
"price_minor": 17,
"currency": "USD",
"expires_at": "2026-09-27T10:25:00.000Z",
"sms": []
}
Ginawa para sa automation
Lahat ng kailangan ng integration mo, sa parehong imbentaryo ng numero, accounting at refund ng app.
-
Simpleng REST API
Nahuhulaang JSON, idempotent na pagbili at malinaw na dahilan ng error na maaari mong aksyunan.
-
Pinirmahang webhook
Mga event na may HMAC na pirma para sa bawat code at pagbabago ng status, na may muling pagsubok nang 24 na oras.
-
Long polling
Hawakan ang request nang hanggang 25 segundo at makuha ang code sa sandaling dumating.
-
Tugma sa sms-activate
Ituro ang iyong mga tool sa aming endpoint. Pareho pa rin ang mga aksyon at tugon.
-
Mga key na hawak mo
Mga key na basa lang o pambili, IP allowlist, pang-araw-araw na limitasyon, expiry at rotation nang walang downtime.
-
Awtomatikong refund
Walang code bago mag-expire ang numero? Agad na bumabalik ang pera sa balanse mo.
-
Paggamit at log ng request
Pang-araw-araw na request, gastos at error bawat key, dagdag ang nafi-filter na log ng nakaraang 7 araw.
-
Presyong ayon sa volume
Kaparehong presyo ng app, na may diskwentong kusang lumalaki kasabay ng buwanang volume mo.
Magsimula sa apat na hakbang
Ilang tawag lang bago ang unang numero.
-
Gumawa ng account
Mag-sign up gamit ang email at i-verify ito. Iisang account ang ginagamit ng app at website.
-
Gumawa ng API key
Piliin ang access, limitahan ang key sa iyong mga server at kopyahin ang secret nang isang beses.
-
Bumili ng numero
I-POST ang serbisyo at bansa. Agad na bumabalik ang numero at presyo.
-
Tanggapin ang code
Hintayin ito sa long polling o webhook, pagkatapos ay tapusin ang activation.
Presyong bumababa habang lumalaki ka
Pareho ang singil ng API sa presyo sa app. Lumalaki ang wholesale discount mo kasabay ng gastos mo sa nakaraang 30 araw sa lahat ng channel.
- Hindi kailanman mas mahal kaysa sa parehong numero sa app
- Awtomatikong nire-refund ang mga numerong walang code
- Naa-update ang tier ilang minuto matapos maabot
- Sinisingil sa USD mula sa parehong balanse ng app
Paglipat
Lumipat mula sa sms-activate sa isang linya
Pareho ang protocol ng aming tugmang endpoint, kaya gagana ang mga bot at panel para sa sms-activate sa sandaling palitan mo ang base URL at key.
Nagsara ang SMS-Activate noong Disyembre 2025. Ituro ang iyong mga tool sa SmsGrab at tuloy-tuloy silang gagana.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices at iba pang karaniwang aksyon
- Numerikong activation ID, service code at country ID na ginagamit mo na
- Parehong mga key, limitasyon, presyo, refund at webhook gaya ng REST API
curl
BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"
curl -s -w '\n' "$BASE&action=getBalance"
curl -s -w '\n' "$BASE&action=getNumber&service=tg&country=6&maxPrice=0.30"
curl -s -w '\n' "$BASE&action=getStatus&id=100000123"
curl -s -w '\n' "$BASE&action=setStatus&id=100000123&status=6"
Python
import os
import time
import requests
BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]
def action(name: str, **params) -> str:
response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
response.raise_for_status()
return response.text
print(action("getBalance"))
answer = action("getNumber", service="tg", country=6, maxPrice="0.30")
if not answer.startswith("ACCESS_NUMBER:"):
raise SystemExit(answer)
_, activation_id, number = answer.split(":")
print("Number:", number)
while True:
status = action("getStatus", id=activation_id)
if status.startswith("STATUS_OK:"):
print("Code:", status.split(":", 1)[1])
action("setStatus", id=activation_id, status=6)
break
if status == "STATUS_CANCEL":
print("Cancelled or expired, the charge was refunded")
break
time.sleep(5)
Node.js
const BASE = 'https://smsgrab.com/api/stubs/handler_api.php';
async function action(name, params = {}) {
const url = new URL(BASE);
url.search = new URLSearchParams({ api_key: process.env.SMSGRAB_API_KEY, action: name, ...params }).toString();
const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
return response.text();
}
console.log(await action('getBalance'));
const answer = await action('getNumber', { service: 'tg', country: '6', maxPrice: '0.30' });
if (!answer.startsWith('ACCESS_NUMBER:')) {
throw new Error(answer);
}
const [, id, number] = answer.split(':');
console.log('Number:', number);
for (;;) {
const status = await action('getStatus', { id });
if (status.startsWith('STATUS_OK:')) {
console.log('Code:', status.slice('STATUS_OK:'.length));
await action('setStatus', { id, status: '6' });
break;
}
if (status === 'STATUS_CANCEL') {
console.log('Cancelled or expired, the charge was refunded');
break;
}
await new Promise((resolve) => setTimeout(resolve, 5000));
}
PHP
<?php
function smsgrab(string $action, array $params = []): string
{
$query = http_build_query(['api_key' => getenv('SMSGRAB_API_KEY'), 'action' => $action] + $params);
$answer = file_get_contents('https://smsgrab.com/api/stubs/handler_api.php?'.$query, false, stream_context_create(['http' => ['timeout' => 30]]));
if ($answer === false) {
throw new RuntimeException('The request failed');
}
return $answer;
}
echo smsgrab('getBalance').PHP_EOL;
$answer = smsgrab('getNumber', ['service' => 'tg', 'country' => 6, 'maxPrice' => '0.30']);
if (! str_starts_with($answer, 'ACCESS_NUMBER:')) {
exit($answer.PHP_EOL);
}
[, $id, $number] = explode(':', $answer);
echo 'Number: '.$number.PHP_EOL;
while (true) {
$status = smsgrab('getStatus', ['id' => $id]);
if (str_starts_with($status, 'STATUS_OK:')) {
echo 'Code: '.substr($status, strlen('STATUS_OK:')).PHP_EOL;
smsgrab('setStatus', ['id' => $id, 'status' => 6]);
break;
}
if ($status === 'STATUS_CANCEL') {
echo 'Cancelled or expired, the charge was refunded'.PHP_EOL;
break;
}
sleep(5);
}
Go
package main
import (
"fmt"
"io"
"net/http"
"net/url"
"os"
"strings"
"time"
)
const base = "https://smsgrab.com/api/stubs/handler_api.php"
var client = &http.Client{Timeout: 30 * time.Second}
func action(name string, params url.Values) (string, error) {
query := url.Values{"api_key": {os.Getenv("SMSGRAB_API_KEY")}, "action": {name}}
for key, values := range params {
query[key] = values
}
response, err := client.Get(base + "?" + query.Encode())
if err != nil {
return "", err
}
defer response.Body.Close()
body, err := io.ReadAll(io.LimitReader(response.Body, 1<<20))
if err != nil {
return "", err
}
if response.StatusCode != http.StatusOK {
return "", fmt.Errorf("http %d: %s", response.StatusCode, body)
}
return string(body), nil
}
func main() {
answer, err := action("getNumber", url.Values{"service": {"tg"}, "country": {"6"}, "maxPrice": {"0.30"}})
if err != nil {
panic(err)
}
if !strings.HasPrefix(answer, "ACCESS_NUMBER:") {
fmt.Println(answer)
return
}
parts := strings.Split(answer, ":")
id := parts[1]
fmt.Println("Number:", parts[2])
for {
status, err := action("getStatus", url.Values{"id": {id}})
if err != nil {
panic(err)
}
if code, ok := strings.CutPrefix(status, "STATUS_OK:"); ok {
fmt.Println("Code:", code)
if _, err := action("setStatus", url.Values{"id": {id}, "status": {"6"}}); err != nil {
panic(err)
}
return
}
if status == "STATUS_CANCEL" {
fmt.Println("Cancelled or expired, the charge was refunded")
return
}
time.Sleep(5 * time.Second)
}
}
Real time
Diretso sa server mo ang mga code
Mag-subscribe sa mga event na kailangan mo at ihahatid namin ang mga ito sa iyong HTTPS endpoint na may pirmang maaaring i-verify.
- Nabili ang numero
- Natanggap ang code
- Tapos ang activation
- Kinansela ang activation
- Nag-expire ang activation
- Na-refund
- Mababa ang balanse
- Nagawa ang top up
- Kinukumpirma ang top up
- Naidagdag ang top up
- Nag-expire ang top up
- Sinusuri ang top up
- Bawat delivery ay pinirmahan ng HMAC-SHA256 na may timestamp
- Pampublikong HTTPS endpoint lang, sinusuri bago ang bawat delivery
- Test delivery, 30 araw na history at muling pagpapadala sa isang click
Mga tanong ng developer
Magkano ang developer API?
Walang subscription. Kapareho ng presyo sa app ang bawat numero at binabayaran mula sa parehong balanse. Ibinababa ng mga volume tier ang presyong iyon habang lumalaki ang gastos mo sa 30 araw, at may nakapirming diskwento ang mga aprubadong reseller. Awtomatikong nire-refund ang mga numerong walang code.
Paano kung hindi dumating ang code?
Aktibo ang numero hanggang sa oras ng pag-expire na ipinapakita kasama nito, karaniwang 10 hanggang 20 minuto. Kung walang code sa panahong iyon, o kinansela mo ang numero habang naghihintay pa, awtomatikong babalik ang pera sa balanse mo.
Magagamit ko ba ang integration ko sa sms-activate?
Oo. Palitan ang base URL sa aming tugmang endpoint at gamitin ang SmsGrab key. Pareho pa rin ang mga karaniwang aksyon, tugon at numerikong ID.
Ano ang mga rate limit?
Bilang default, ang bawat key ay makakagawa ng 600 request at 60 pagbili kada minuto, lahat ng key ng account ay 3000 request kada minuto nang magkakasama, at hanggang 100 numero ang maaaring sabay-sabay na maghintay ng code.
Paano ko poprotektahan ang key ko?
Itago lang ang mga key sa server, bigyan ang bawat app ng sariling key, limitahan ito sa address ng server at magtakda ng pang-araw-araw na limitasyon. Kung posibleng na-leak ang key, i-rotate o bawiin ito mula sa account mo.
Mas maraming sagot sa help center