Chagua lugha

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

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.

  1. Fungua akaunti

    Jisajili kwa barua pepe na uithibitishe. Programu na tovuti hutumia akaunti moja.

  2. Unda ufunguo wa API

    Chagua ufikiaji, zuia ufunguo kwa seva zako na unakili siri mara moja.

  3. Nunua namba

    POST huduma na nchi. Namba na bei hurudi papo hapo.

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

Punguzo kwa matumizi ya siku 30

Viwango vya kiasi havitumiki kwa sasa. Unalipa bei zilezile za programu, na wauzaji walioidhinishwa hupata punguzo lao la kudumu.

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
Marejeo ya uoanifu

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
Mwongozo wa webhook
600maombi kwa dakika kwa kila ufunguo
60manunuzi kwa dakika kwa kila ufunguo
100namba zinazosubiri kwa wakati mmoja
25sekunde za long polling
  • 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.

Je, programu na API zinashiriki salio?

Ndiyo. API hutumia salio la akaunti yako ya SmsGrab, na kila ununuzi na marejesho huonekana kwenye pochi yako kama mengine.

Majibu zaidi katika kituo cha msaada

Uko tayari kuendesha uthibitishaji kiotomatiki?

Unda ufunguo kwenye akaunti yako na ufanye mwito wa kwanza ndani ya dakika chache.