اختيار اللغة

واجهة المطوّرين البرمجية

التحقق عبر SMS مباشرة من شيفرتك

استدعاء HTTPS واحد يمنح البوت أو المنصة رقمًا حقيقيًا لواتساب وتيليجرام وخدمات أخرى كثيرة. استلم الرمز عبر ويب هوك أو الاستطلاع الطويل، وادفع فقط مقابل الأرقام التي وصلها الرمز.

  • ٢٬٢٨١خدمة
  • ٢٠٠دولة
  • تلقائياسترداد إن لم يصل الرمز

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

مصممة للأتمتة

كل ما يحتاجه تكاملك، بالمخزون والمحاسبة والاستردادات نفسها التي في التطبيق.

  • واجهة REST واضحة

    JSON متوقع، ومشتريات متكررة بأمان، وأسباب أخطاء واضحة يمكنك التعامل معها.

  • ويب هوك موقّعة

    أحداث موقّعة بـ HMAC لكل رمز وتغيير حالة، مع إعادة المحاولة لمدة 24 ساعة.

  • الاستطلاع الطويل

    أبقِ الطلب مفتوحًا حتى 25 ثانية واستلم الرمز لحظة وصوله.

  • متوافق مع sms-activate

    وجّه أدواتك الحالية إلى عنواننا. تبقى الإجراءات والاستجابات كما هي.

  • مفاتيح تتحكم بها

    مفاتيح للقراءة فقط أو للشراء، وقوائم IP مسموحة، وحدود يومية، وصلاحية، وتبديل دون توقف.

  • استردادات تلقائية

    لم يصل الرمز قبل انتهاء الرقم؟ يعود المبلغ إلى رصيدك فورًا.

  • الاستخدام وسجل الطلبات

    الطلبات والإنفاق والأخطاء يوميًا لكل مفتاح، مع سجل قابل للتصفية لآخر 7 أيام.

  • أسعار حسب الحجم

    الأسعار نفسها في التطبيق، مع خصومات تزداد تلقائيًا مع حجمك الشهري.

ابدأ في أربع خطوات

بضعة استدعاءات فقط تفصلك عن أول رقم.

  1. أنشئ حسابًا

    سجّل ببريدك الإلكتروني وأكّده. التطبيق والموقع يستخدمان الحساب نفسه.

  2. أنشئ مفتاح API

    اختر الوصول وقيّد المفتاح بخوادمك وانسخ السر مرة واحدة.

  3. اشترِ رقمًا

    أرسل الخدمة والدولة بطلب POST. يصلك الرقم والسعر فورًا.

  4. استلم الرمز

    انتظره عبر الاستطلاع الطويل أو الويب هوك، ثم أنهِ التفعيل.

أسعار تنخفض كلما نموت

تطبّق الواجهة البرمجية أسعار التطبيق نفسها. ويزداد خصم الجملة الخاص بك مع إنفاقك خلال آخر 30 يومًا عبر كل القنوات.

  • لا تتجاوز أبدًا سعر الرقم نفسه في التطبيق
  • الأرقام التي لا يصلها رمز تُسترد تلقائيًا
  • يتحدث مستواك خلال دقائق من بلوغه
  • يُخصم بالدولار من رصيد التطبيق نفسه

الخصم حسب الإنفاق خلال 30 يومًا

مستويات الحجم غير مفعّلة حاليًا. تدفع أسعار التطبيق نفسها، ويحصل الموزعون المعتمدون على خصمهم الثابت.

الانتقال

انتقل من sms-activate بتغيير سطر واحد

عنواننا المتوافق يتحدث البروتوكول نفسه، فتعمل البوتات ولوحات التحكم المصممة لـ sms-activate بمجرد تغيير العنوان الأساسي والمفتاح.

أُغلقت SMS-Activate في ديسمبر 2025. وجّه أدواتك إلى SmsGrab لتواصل العمل.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber وgetStatus وsetStatus وgetPrices وبقية الإجراءات القياسية
  • معرّفات التفعيل الرقمية ورموز الخدمات ومعرّفات الدول التي تستخدمها بالفعل
  • المفاتيح والحدود والأسعار والاستردادات والويب هوك نفسها كما في واجهة REST
مرجع التوافق

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

في الوقت الفعلي

الرموز تصل مباشرة إلى خادمك

اشترك في الأحداث التي تهمك، وسنسلّمها إلى عنوان HTTPS الخاص بك مع توقيع يمكنك التحقق منه.

  • تم شراء رقم
  • تم استلام الرمز
  • اكتمل التفعيل
  • أُلغي التفعيل
  • انتهى التفعيل
  • تم الاسترداد
  • الرصيد منخفض
  • أُنشئ الشحن
  • جارٍ تأكيد الشحن
  • أُضيف الشحن إلى الرصيد
  • انتهت صلاحية الشحن
  • الشحن قيد المراجعة
دليل الويب هوك
٦٠٠طلب في الدقيقة لكل مفتاح
٦٠عملية شراء في الدقيقة لكل مفتاح
١٠٠رقم قيد الانتظار في آنٍ واحد
٢٥ثانية من الاستطلاع الطويل
  • كل تسليم موقّع بـ HMAC-SHA256 مع طابع زمني
  • عناوين HTTPS العامة فقط، مع فحصها قبل كل تسليم
  • تسليمات اختبارية وسجل لمدة 30 يومًا وإعادة تسليم بنقرة واحدة

أسئلة المطوّرين

كم تكلف واجهة المطوّرين؟

لا يوجد اشتراك. يكلّف كل رقم ما يكلّفه في التطبيق ويُدفع من الرصيد نفسه. تخفض مستويات الحجم هذا السعر كلما زاد إنفاقك خلال 30 يومًا، ويحصل الموزعون المعتمدون على خصم ثابت. وتُسترد الأرقام التي لم يصلها رمز تلقائيًا.

ماذا يحدث إن لم يصل الرمز؟

يبقى الرقم نشطًا حتى وقت الانتهاء المعروض معه، وهو عادةً بين 10 و20 دقيقة. إن لم يصل رمز خلالها، أو ألغيت الرقم وهو لا يزال في الانتظار، يعود المبلغ إلى رصيدك تلقائيًا.

هل يمكنني استخدام تكاملي مع sms-activate؟

نعم. غيّر العنوان الأساسي إلى عنواننا المتوافق واستخدم مفتاح SmsGrab. تبقى الإجراءات القياسية والاستجابات والمعرّفات الرقمية كما هي.

ما حدود المعدل؟

افتراضيًا يمكن لكل مفتاح إجراء 600 طلب و60 عملية شراء في الدقيقة، ولكل مفاتيح الحساب معًا 3000 طلب في الدقيقة، ويمكن أن ينتظر حتى 100 رقم رمزًا في الوقت نفسه.

كيف أحمي مفتاحي؟

احفظ المفاتيح على الخوادم فقط، وامنح كل تطبيق مفتاحه، وقيّده بعناوين خوادمك، وحدّد سقف إنفاق يوميًا. إن احتمل تسرّب مفتاح، بدّله أو ألغِه من حسابك.

هل يتشارك التطبيق والواجهة الرصيد نفسه؟

نعم. تستخدم الواجهة رصيد حسابك في SmsGrab، وتظهر كل عملية شراء واسترداد في محفظتك مثل أي عملية أخرى.

مزيد من الإجابات في مركز المساعدة

مستعد لأتمتة التحقق؟

أنشئ مفتاحًا في حسابك ونفّذ أول استدعاء خلال دقائق.