Pumili ng wika

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)
201 Created
{
  "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.

  1. Gumawa ng account

    Mag-sign up gamit ang email at i-verify ito. Iisang account ang ginagamit ng app at website.

  2. Gumawa ng API key

    Piliin ang access, limitahan ang key sa iyong mga server at kopyahin ang secret nang isang beses.

  3. Bumili ng numero

    I-POST ang serbisyo at bansa. Agad na bumabalik ang numero at presyo.

  4. 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

Diskwento ayon sa gastos sa 30 araw

Hindi aktibo ngayon ang mga volume tier. Kaparehong presyo ng app ang babayaran mo, at may nakapirming diskwento ang mga aprubadong reseller.

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
Sanggunian sa compatibility

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
Gabay sa webhook
600request kada minuto bawat key
60pagbili kada minuto bawat key
100sabay-sabay na naghihintay na numero
25segundo ng long polling
  • 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.

Iisa ba ang balanse ng app at API?

Oo. Ginagamit ng API ang balanse ng SmsGrab account mo, at lumalabas sa wallet mo ang bawat pagbili at refund gaya ng iba.

Mas maraming sagot sa help center

Handa nang i-automate ang verification?

Gumawa ng key sa account mo at gawin ang unang tawag sa loob ng ilang minuto.