واجهة المطوّرين البرمجية
التحقق عبر 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)
{
"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 أيام.
-
أسعار حسب الحجم
الأسعار نفسها في التطبيق، مع خصومات تزداد تلقائيًا مع حجمك الشهري.
ابدأ في أربع خطوات
بضعة استدعاءات فقط تفصلك عن أول رقم.
-
أنشئ حسابًا
سجّل ببريدك الإلكتروني وأكّده. التطبيق والموقع يستخدمان الحساب نفسه.
-
أنشئ مفتاح API
اختر الوصول وقيّد المفتاح بخوادمك وانسخ السر مرة واحدة.
-
اشترِ رقمًا
أرسل الخدمة والدولة بطلب POST. يصلك الرقم والسعر فورًا.
-
استلم الرمز
انتظره عبر الاستطلاع الطويل أو الويب هوك، ثم أنهِ التفعيل.
أسعار تنخفض كلما نموت
تطبّق الواجهة البرمجية أسعار التطبيق نفسها. ويزداد خصم الجملة الخاص بك مع إنفاقك خلال آخر 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 رقم رمزًا في الوقت نفسه.
كيف أحمي مفتاحي؟
احفظ المفاتيح على الخوادم فقط، وامنح كل تطبيق مفتاحه، وقيّده بعناوين خوادمك، وحدّد سقف إنفاق يوميًا. إن احتمل تسرّب مفتاح، بدّله أو ألغِه من حسابك.
مزيد من الإجابات في مركز المساعدة