API ya wasanidi
Uthibitishaji wa SMS moja kwa moja kutoka kwa msimbo wako
Mwito mmoja wa HTTPS unaipa boti au jukwaa lako namba halisi ya WhatsApp, Telegram na huduma nyingine nyingi. Pokea msimbo kwa webhook au long polling na ulipie tu namba zilizopokea msimbo.
- 2,281huduma
- 200nchi
- Kiotomatikimarejesho msimbo usipofika
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": []
}
Imeundwa kwa uendeshaji otomatiki
Kila kitu ambacho muunganisho wako unahitaji, kwa hifadhi ya namba, uhasibu na marejesho yale yale ya programu.
-
REST API rahisi
JSON inayotabirika, manunuzi idempotent na sababu wazi za hitilafu unazoweza kushughulikia.
-
Webhook zilizotiwa saini
Matukio yaliyotiwa saini ya HMAC kwa kila msimbo na mabadiliko ya hali, yakijaribiwa tena kwa saa 24.
-
Long polling
Shikilia ombi hadi sekunde 25 na upokee msimbo papo hapo unapofika.
-
Inaoana na sms-activate
Elekeza zana zako zilizopo kwenye endpoint yetu. Vitendo na majibu hayabadiliki.
-
Funguo unazodhibiti
Funguo za kusoma au kununua, orodha ya IP, vikomo vya kila siku, muda wa kuisha na mzunguko bila kukatika.
-
Marejesho ya kiotomatiki
Msimbo haukufika kabla namba haijaisha muda? Pesa zinarudi kwenye salio lako mara moja.
-
Matumizi na kumbukumbu
Maombi, matumizi na hitilafu za kila siku kwa kila ufunguo, pamoja na kumbukumbu ya siku 7 zilizopita inayochujika.
-
Bei za kiasi
Bei zilezile za programu, zenye punguzo linalokua kiotomatiki kadiri kiasi chako cha kila mwezi kinavyoongezeka.
Anza kwa hatua nne
Miito michache tu hadi namba yako ya kwanza.
-
Fungua akaunti
Jisajili kwa barua pepe na uithibitishe. Programu na tovuti hutumia akaunti moja.
-
Unda ufunguo wa API
Chagua ufikiaji, zuia ufunguo kwa seva zako na unakili siri mara moja.
-
Nunua namba
POST huduma na nchi. Namba na bei hurudi papo hapo.
-
Pokea msimbo
Usubiri kwa long polling au webhook, kisha ukamilishe uamilishaji.
Bei zinazoshuka unapokua
API hutoza bei zilezile za programu. Punguzo lako la jumla hukua kulingana na matumizi yako ya siku 30 zilizopita kwenye njia zote.
- Kamwe si ghali kuliko namba ile ile kwenye programu
- Namba zisizopokea msimbo hurejeshwa kiotomatiki
- Kiwango husasishwa ndani ya dakika chache baada ya kufikiwa
- Hutozwa kwa USD kutoka salio lile lile la programu
Uhamisho
Hama kutoka sms-activate kwa mstari mmoja
Endpoint yetu inayooana hutumia itifaki ile ile, kwa hiyo boti na paneli za sms-activate hufanya kazi mara unapobadilisha URL ya msingi na ufunguo.
SMS-Activate ilifungwa Desemba 2025. Elekeza zana zako kwa SmsGrab na ziendelee kufanya kazi.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices na vitendo vingine vya kawaida
- Vitambulisho vya uamilishaji vya namba, misimbo ya huduma na vitambulisho vya nchi unavyotumia tayari
- Funguo, mipaka, bei, marejesho na webhook zile zile za 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)
}
}
Wakati halisi
Misimbo moja kwa moja kwenye seva yako
Jiandikishe kwa matukio unayohitaji nasi tutayawasilisha kwa endpoint yako ya HTTPS pamoja na saini unayoweza kuthibitisha.
- Namba imenunuliwa
- Msimbo umepokelewa
- Uamilishaji umekamilika
- Uamilishaji umeghairiwa
- Uamilishaji umeisha muda
- Imerejeshwa
- Salio liko chini
- Ombi la kuongeza salio limeundwa
- Kuongeza salio kunathibitishwa
- Salio limeongezwa
- Ombi la kuongeza salio limeisha muda
- Kuongeza salio kunakaguliwa
- Kila uwasilishaji umetiwa saini ya HMAC-SHA256 pamoja na muhuri wa muda
- Endpoint za HTTPS za umma pekee, hukaguliwa kabla ya kila uwasilishaji
- Uwasilishaji wa majaribio, historia ya siku 30 na kuwasilisha tena kwa mbofyo mmoja
Maswali ya wasanidi
API ya wasanidi inagharimu kiasi gani?
Hakuna usajili wa kulipia. Kila nambari inagharimu sawa na kwenye programu na hulipwa kutoka salio lilelile. Viwango vya kiasi hupunguza bei hiyo kadiri matumizi yako ya siku 30 yanavyoongezeka, na wauzaji walioidhinishwa hupata punguzo la kudumu. Nambari zisizopata msimbo hurejeshewa pesa kiotomatiki.
Itakuwaje msimbo usipofika?
Namba iko hai hadi muda wa kuisha unaoonyeshwa pamoja nayo, kwa kawaida dakika 10 hadi 20. Msimbo usipofika katika muda huo, au ukighairi namba ikiwa bado inasubiri, pesa hurudi kwenye salio lako kiotomatiki.
Je, naweza kutumia muunganisho wangu wa sms-activate?
Ndiyo. Badilisha URL ya msingi kuwa endpoint yetu inayooana na utumie ufunguo wa SmsGrab. Vitendo vya kawaida, majibu na vitambulisho vya namba havibadiliki.
Mipaka ya kasi ni ipi?
Kwa chaguo-msingi kila ufunguo unaweza kufanya maombi 600 na manunuzi 60 kwa dakika, funguo zote za akaunti kwa pamoja maombi 3000 kwa dakika, na hadi namba 100 zinaweza kusubiri msimbo kwa wakati mmoja.
Nalindaje ufunguo wangu?
Hifadhi funguo kwenye seva pekee, ipe kila programu ufunguo wake, uzuie kwa anwani za seva na uweke kikomo cha matumizi ya kila siku. Ufunguo ukiwa huenda umevuja, uzungushe au uubatilishe kutoka akaunti yako.
Majibu zaidi katika kituo cha msaada