Pilih bahasa

API Pembangun

Pengesahan SMS terus dari kod anda

Satu panggilan HTTPS memberi bot atau platform anda nombor sebenar untuk WhatsApp, Telegram dan banyak perkhidmatan lain. Terima kod melalui webhook atau long polling dan bayar hanya untuk nombor yang menerima kod.

  • 2,281perkhidmatan
  • 200negara
  • Automatikbayaran balik jika tiada kod

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": []
}

Dibina untuk automasi

Semua yang diperlukan integrasi anda, dengan stok nombor, perakaunan dan bayaran balik yang sama seperti aplikasi.

  • REST API ringkas

    JSON yang boleh dijangka, pembelian idempoten dan sebab ralat jelas yang boleh anda tangani.

  • Webhook bertandatangan

    Acara bertandatangan HMAC untuk setiap kod dan perubahan status, dengan cubaan semula selama 24 jam.

  • Long polling

    Tahan permintaan sehingga 25 saat dan terima kod sebaik ia tiba.

  • Serasi sms-activate

    Halakan alat sedia ada ke endpoint kami. Tindakan dan respons kekal sama.

  • Kunci dalam kawalan anda

    Kunci baca atau beli, senarai IP dibenarkan, had harian, tempoh dan putaran tanpa gangguan.

  • Bayaran balik automatik

    Tiada kod sebelum nombor tamat? Wang kembali ke baki anda serta-merta.

  • Penggunaan dan log

    Permintaan, perbelanjaan dan ralat harian setiap kunci, serta log 7 hari lepas yang boleh ditapis.

  • Harga volum

    Harga yang sama seperti dalam apl, dengan diskaun yang meningkat secara automatik mengikut volum bulanan anda.

Mula dalam empat langkah

Hanya beberapa panggilan ke nombor pertama anda.

  1. Cipta akaun

    Daftar dengan e-mel dan sahkannya. Aplikasi dan laman web menggunakan akaun yang sama.

  2. Cipta kunci API

    Pilih akses, hadkan kunci kepada pelayan anda dan salin rahsia sekali.

  3. Beli nombor

    POST perkhidmatan dan negara. Nombor dan harga dikembalikan serta-merta.

  4. Terima kod

    Tunggu melalui long polling atau webhook, kemudian tamatkan pengaktifan.

Harga yang turun apabila anda berkembang

API mengenakan harga yang sama seperti apl. Diskaun borong anda meningkat mengikut perbelanjaan 30 hari lepas di semua saluran.

  • Tidak pernah lebih mahal daripada nombor yang sama dalam aplikasi
  • Nombor tanpa kod dibayar balik secara automatik
  • Peringkat dikemas kini dalam beberapa minit selepas dicapai
  • Dicaj dalam USD daripada baki yang sama dengan aplikasi

Diskaun mengikut perbelanjaan 30 hari

Peringkat volum tidak aktif sekarang. Anda membayar harga yang sama seperti dalam apl, dan penjual semula yang diluluskan mendapat diskaun tetap mereka.

Migrasi

Beralih dari sms-activate dengan satu baris

Endpoint serasi kami menggunakan protokol yang sama, jadi bot dan panel untuk sms-activate berfungsi sebaik anda menukar URL asas dan kunci.

SMS-Activate ditutup pada Disember 2025. Halakan alatan anda ke SmsGrab dan ia terus berfungsi.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices dan tindakan standard lain
  • ID pengaktifan berangka, kod perkhidmatan dan ID negara yang anda gunakan sekarang
  • Kunci, had, harga, bayaran balik dan webhook yang sama seperti REST API
Rujukan keserasian

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)
	}
}

Masa nyata

Kod terus ke pelayan anda

Langgan acara yang anda perlukan dan kami menghantarnya ke endpoint HTTPS anda dengan tandatangan yang boleh disahkan.

  • Nombor dibeli
  • Kod diterima
  • Pengaktifan selesai
  • Pengaktifan dibatalkan
  • Pengaktifan tamat tempoh
  • Bayaran dikembalikan
  • Baki rendah
  • Tambahan baki dicipta
  • Tambahan baki sedang disahkan
  • Tambahan baki dikreditkan
  • Tambahan baki tamat tempoh
  • Tambahan baki dalam semakan
Panduan webhook
600permintaan seminit setiap kunci
60pembelian seminit setiap kunci
100nombor menunggu serentak
25saat long polling
  • Setiap penghantaran ditandatangani HMAC-SHA256 dengan cap masa
  • Hanya endpoint HTTPS awam, disemak sebelum setiap penghantaran
  • Penghantaran ujian, sejarah 30 hari dan hantar semula dengan satu klik

Soalan pembangun

Berapakah kos API pembangun?

Tiada langganan. Setiap nombor berharga sama seperti dalam apl dan dibayar daripada baki yang sama. Peringkat volum menurunkan harga itu apabila perbelanjaan 30 hari anda meningkat, dan penjual semula yang diluluskan mendapat diskaun tetap. Nombor tanpa kod dibayar balik secara automatik.

Bagaimana jika kod tidak tiba?

Nombor aktif sehingga masa tamat yang dipaparkan bersamanya, biasanya 10 hingga 20 minit. Jika tiada kod dalam tempoh itu, atau anda membatalkan nombor semasa menunggu, wang kembali ke baki anda secara automatik.

Bolehkah saya menggunakan integrasi sms-activate saya?

Boleh. Tukar URL asas kepada endpoint serasi kami dan gunakan kunci SmsGrab. Tindakan standard, respons dan ID berangka kekal sama.

Apakah had kadarnya?

Secara lalai setiap kunci boleh membuat 600 permintaan dan 60 pembelian seminit, semua kunci akaun bersama 3000 permintaan seminit, dan sehingga 100 nombor boleh menunggu kod serentak.

Bagaimana saya melindungi kunci saya?

Simpan kunci di pelayan sahaja, beri setiap aplikasi kuncinya sendiri, hadkan kepada alamat pelayan dan tetapkan had belanja harian. Jika kunci mungkin terdedah, putar atau batalkannya dari akaun anda.

Adakah aplikasi dan API berkongsi baki?

Ya. API menggunakan baki akaun SmsGrab anda, dan setiap pembelian dan bayaran balik muncul dalam dompet seperti yang lain.

Lebih banyak jawapan di pusat bantuan

Sedia mengautomasikan pengesahan?

Cipta kunci dalam akaun anda dan buat panggilan pertama dalam beberapa minit.