Pilih bahasa

API Developer

Verifikasi SMS langsung dari kode Anda

Satu panggilan HTTPS memberi bot atau platform Anda nomor asli untuk WhatsApp, Telegram, dan banyak layanan lain. Terima kode lewat webhook atau long polling dan bayar hanya untuk nomor yang menerima kode.

  • 2.281layanan
  • 200negara
  • Otomatisrefund jika kode tidak datang

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

Dibuat untuk otomatisasi

Semua yang dibutuhkan integrasi Anda, dengan stok nomor, pembukuan, dan refund yang sama seperti aplikasi.

  • REST API sederhana

    JSON yang dapat diprediksi, pembelian idempoten, dan alasan galat jelas yang bisa Anda tindak lanjuti.

  • Webhook bertanda tangan

    Event bertanda tangan HMAC untuk setiap kode dan perubahan status, dengan percobaan ulang selama 24 jam.

  • Long polling

    Tahan permintaan hingga 25 detik dan terima kode begitu tiba.

  • Kompatibel sms-activate

    Arahkan alat Anda ke endpoint kami. Aksi dan respons tetap sama.

  • Kunci dalam kendali Anda

    Kunci baca atau beli, daftar IP diizinkan, batas harian, masa berlaku, dan rotasi tanpa gangguan.

  • Refund otomatis

    Kode tidak datang sebelum nomor kedaluwarsa? Dana langsung kembali ke saldo Anda.

  • Penggunaan dan log

    Permintaan, pengeluaran, dan galat harian per kunci, plus log 7 hari terakhir yang bisa difilter.

  • Harga volume

    Harga yang sama dengan aplikasi, dengan diskon yang naik otomatis seiring volume bulanan Anda.

Mulai dalam empat langkah

Hanya beberapa panggilan menuju nomor pertama Anda.

  1. Buat akun

    Daftar dengan email dan verifikasi. Aplikasi dan situs memakai akun yang sama.

  2. Buat kunci API

    Pilih akses, batasi kunci ke server Anda, dan salin secret satu kali.

  3. Beli nomor

    POST layanan dan negara. Nomor dan harga langsung dikembalikan.

  4. Terima kode

    Tunggu lewat long polling atau webhook, lalu selesaikan aktivasi.

Harga yang turun saat Anda tumbuh

API mengenakan harga yang sama dengan aplikasi. Diskon grosir Anda naik seiring pengeluaran 30 hari terakhir di semua kanal.

  • Tidak pernah lebih mahal dari nomor yang sama di aplikasi
  • Nomor tanpa kode di-refund otomatis
  • Tingkatan diperbarui dalam beberapa menit setelah tercapai
  • Ditagih dalam USD dari saldo yang sama dengan aplikasi

Diskon menurut pengeluaran 30 hari

Tingkatan volume sedang tidak aktif. Anda membayar harga yang sama dengan di aplikasi, dan reseller yang disetujui mendapat diskon tetapnya.

Migrasi

Pindah dari sms-activate dengan satu baris

Endpoint kompatibel kami memakai protokol yang sama, jadi bot dan panel untuk sms-activate langsung berfungsi setelah Anda mengganti URL dasar dan kunci.

SMS-Activate tutup pada Desember 2025. Arahkan alat Anda ke SmsGrab dan semuanya tetap berjalan.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices, dan aksi standar lainnya
  • ID aktivasi numerik, kode layanan, dan ID negara yang sudah Anda pakai
  • Kunci, batas, harga, refund, dan webhook yang sama dengan REST API
Referensi kompatibilitas

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

Waktu nyata

Kode langsung ke server Anda

Berlangganan event yang Anda perlukan dan kami kirimkan ke endpoint HTTPS Anda dengan tanda tangan yang bisa diverifikasi.

  • Nomor dibeli
  • Kode diterima
  • Aktivasi selesai
  • Aktivasi dibatalkan
  • Aktivasi kedaluwarsa
  • Dana dikembalikan
  • Saldo rendah
  • Isi saldo dibuat
  • Isi saldo dikonfirmasi
  • Isi saldo masuk
  • Isi saldo kedaluwarsa
  • Isi saldo ditinjau
Panduan webhook
600permintaan per menit per kunci
60pembelian per menit per kunci
100nomor menunggu bersamaan
25detik long polling
  • Setiap pengiriman ditandatangani HMAC-SHA256 dengan stempel waktu
  • Hanya endpoint HTTPS publik, diperiksa sebelum setiap pengiriman
  • Pengiriman uji, riwayat 30 hari, dan kirim ulang sekali klik

Pertanyaan developer

Berapa biaya API developer?

Tidak ada langganan. Setiap nomor berharga sama seperti di aplikasi dan dibayar dari saldo yang sama. Tingkatan volume menurunkan harga itu seiring naiknya pengeluaran 30 hari Anda, dan reseller yang disetujui mendapat diskon tetap. Nomor tanpa kode dikembalikan dananya secara otomatis.

Bagaimana jika kode tidak datang?

Nomor aktif hingga waktu kedaluwarsa yang ditampilkan bersamanya, biasanya 10 hingga 20 menit. Jika tidak ada kode dalam waktu itu, atau Anda membatalkan nomor saat masih menunggu, dana otomatis kembali ke saldo Anda.

Bisakah saya memakai integrasi sms-activate saya?

Bisa. Ganti URL dasar ke endpoint kompatibel kami dan gunakan kunci SmsGrab. Aksi standar, respons, dan ID numerik tetap sama.

Apa batas lajunya?

Secara bawaan setiap kunci dapat melakukan 600 permintaan dan 60 pembelian per menit, semua kunci dalam akun bersama-sama 3000 permintaan per menit, dan hingga 100 nomor dapat menunggu kode bersamaan.

Bagaimana melindungi kunci saya?

Simpan kunci hanya di server, beri setiap aplikasi kuncinya sendiri, batasi ke alamat server, dan tetapkan batas belanja harian. Jika kunci mungkin bocor, rotasi atau cabut dari akun Anda.

Apakah aplikasi dan API berbagi saldo?

Ya. API memakai saldo akun SmsGrab Anda, dan setiap pembelian serta refund muncul di dompet seperti transaksi lainnya.

Jawaban lain di pusat bantuan

Siap mengotomatiskan verifikasi?

Buat kunci di akun Anda dan lakukan panggilan pertama dalam hitungan menit.