معلومات الاتصال
| رابط API | https://arb0.com/api/v2 |
|---|---|
| طريقة الطلب | POST |
| صيغة الإرسال | application/x-www-form-urlencoded أو JSON |
| صيغة الرد | JSON |
| مفتاح API | من صفحة الحساب |
الواجهة متوافقة مع صيغة لوحات SMM القياسية (API v2)، لذلك تعمل مع أغلب سكربتات الريسيلر الجاهزة.
قائمة الخدمات
services| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | services |
مثال على الرد
[
{
"service": "1",
"name": "رشق أعضاء تيليجرام",
"type": "Default",
"category": "تيليجرام",
"rate": "0.9000",
"min": "50",
"max": "10000",
"refill": false,
"cancel": false
}
]
إنشاء طلب
add| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | add |
service | رقم الخدمة |
link | الرابط |
quantity | الكمية |
answer | رقم الإجابة (لخدمات التصويت فقط) |
speed | اختياري — السرعة بالثواني: 0 أو max = أقصى سرعة، أو 1 إلى 300 |
lang | اختياري — نوع الحسابات (يمثل لغة نظام الحساب): ar / en — راجع جدول الأنواع |
gender | اختياري — 0 مختلط، 1 بنات (female)، 2 أولاد (male) |
message | لخدمات الرسائل فقط — نص الرسالة (يقبل أيضاً comments) |
server | اختياري — 1 وهمية (fake) أو 2 حقيقية (real) |
مثال على الرد
{
"order": 23501
}
حالة طلب
status| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | status |
order | رقم الطلب |
مثال على الرد
{
"charge": "0.2782",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "USD"
}
حالة عدة طلبات
status (multi)| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | status |
orders | أرقام الطلبات مفصولة بفاصلة (حتى 100) |
مثال على الرد
{
"1": {"charge": "0.2782", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD"},
"10": {"error": "Incorrect order ID"}
}
إيقاف طلبات
cancel| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | cancel |
orders | أرقام الطلبات مفصولة بفاصلة (حتى 100) |
مثال على الرد
[
{"order": 9, "cancel": 1},
{"order": 2, "cancel": {"error": "لا يمكن إيقاف هذا الطلب."}}
]
إعادة تعبئة
refill| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | refill |
order | رقم الطلب |
مثال على الرد
{
"refill": "1"
}
إعادة تعبئة عدة طلبات
refill (multi)| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | refill |
orders | أرقام الطلبات مفصولة بفاصلة (حتى 100) |
مثال على الرد
[
{"order": 1, "refill": 1},
{"order": 3, "refill": {"error": "هذه الخدمة لا تدعم إعادة التعبئة."}}
]
حالة إعادة التعبئة
refill_status| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | refill_status |
refill | رقم إعادة التعبئة (أو refills لعدة أرقام) |
مثال على الرد
{
"status": "Completed"
}
الرصيد
balance| المعامل | الوصف |
|---|---|
key | مفتاح API |
action | balance |
مثال على الرد
{
"balance": "100.8429",
"currency": "USD"
}
خيارات الطلب (السرعة، نوع الحسابات، الجنس...)
كل خدمة تحدد الخيارات التي تدعمها. اطلب action=services وستجد لكل خدمة الحقل options بالقيم المسموحة والافتراضية:
"options": {
"answer": {"required": true, "type": "integer"},
"speed": {"required": false, "default": 0, "min": 0, "max": 300, "unit": "seconds", "note": "0 = max speed"},
"lang": {"required": false, "default": "ar", "values": {"ar": "...", "en": "..."}},
"gender": {"required": false, "default": 0, "values": {"0": "mixed", "1": "female", "2": "male"}}
}
- إذا لم ترسل الخيار تُستخدم القيمة الافتراضية.
- إذا أرسلت قيمة غير صحيحة يُرفض الطلب برسالة خطأ واضحة، ولا يُخصم أي رصيد.
- الخيارات التي لا تدعمها الخدمة تُتجاهل، فالسكربتات القياسية تعمل بدون تعديل.
أنواع الحسابات المتاحة (lang) — تمثل لغة نظام الحساب
| القيمة | النوع | التوضيح |
|---|---|---|
ar | حسابات عربية (ar) | حسابات عربية — لغة نظام الحساب: العربية |
en | حسابات عربية (en) | حسابات عربية — لغة نظام الحساب: الإنجليزية |
مثال: تصويت بحسابات عربية بنات، بسرعة 15 ثانية
curl -X POST https://arb0.com/api/v2 \ -d key=YOUR_KEY -d action=add -d service=20 \ -d link=https://t.me/channel/123 -d quantity=500 \ -d answer=2 -d lang=ar -d gender=1 -d speed=15
مثال بلغة PHP
$post = ['key' => 'YOUR_KEY', 'action' => 'add', 'service' => 21,
'link' => 'https://t.me/group', 'quantity' => 100,
'message' => 'مرحبا بكم', 'server' => 2];
مثال بلغة Python
requests.post("https://arb0.com/api/v2", data={"key": "YOUR_KEY", "action": "add", "service": 22,
"link": "https://t.me/channel", "quantity": 1000, "gender": "male", "speed": "max"}).json()
الأخطاء والحالات
عند وجود خطأ يكون الرد بالشكل: {"error": "رسالة الخطأ"}
قيم status الممكنة: Pending، Processing، In progress، Completed، Partial، Canceled.
أمثلة أخطاء الخيارات: Invalid speed: use 0 (max) or 1-300 seconds، Invalid lang: use one of ar, en، Invalid gender: use 0 (mixed), 1 (female) or 2 (male).
في services: الحقل cancel = الخدمة تدعم الإيقاف، وrefill = تدعم إعادة التعبئة. حالات إعادة التعبئة: Pending، In progress، Completed، Rejected.
الحد الأقصى: 120 طلب في الدقيقة لكل مفتاح.
مثال Python
import requests
API = "https://arb0.com/api/v2"
KEY = "YOUR_API_KEY"
r = requests.post(API, data={
"key": KEY, "action": "add",
"service": 1, "link": "https://t.me/channel",
"quantity": 1000,
})
print(r.json()) # {"order": 23501}
مثال PHP
$ch = curl_init("https://arb0.com/api/v2");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POSTFIELDS => http_build_query([
"key" => "YOUR_API_KEY",
"action" => "balance",
]),
]);
echo curl_exec($ch);