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)
{
"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.
-
Buat akun
Daftar dengan email dan verifikasi. Aplikasi dan situs memakai akun yang sama.
-
Buat kunci API
Pilih akses, batasi kunci ke server Anda, dan salin secret satu kali.
-
Beli nomor
POST layanan dan negara. Nomor dan harga langsung dikembalikan.
-
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
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
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
- 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.
Jawaban lain di pusat bantuan