توثيق GLITCH API

اربط موقعك أو بوتك بخدماتنا: مفتاح واحد، واستدعاء مخصص لكل قسم.

مقدمة

واجهة برمجية للتجار: اربط موقعك أو بوتك بخدماتنا. لكل قسم استدعاء لعرض خدماته وآخر للشراء. كل الردود JSON عبر HTTPS، والرصيد المستخدم هو رصيد حسابك في البوت (تشحنه بنفس طرق الإيداع).

رابط الـ API الأساسي (Base URL)

https://glitchnum.duckdns.org/v1

كل المسارات في هذه الصفحة تُلحق بهذا الرابط. مثال: GET https://glitchnum.duckdns.org/v1/balance مع الهيدر X-API-Key: YOUR_API_KEY.

المصادقة والـ Headers

أرسل مفتاحك مع كل طلب. المفتاح سري، ويظهر لك دائماً من زر API في البوت (مع نسخ وتجديد).

Headerالقيمةملاحظة
X-API-KeyYOUR_API_KEYإجباري في كل طلب
Content-Typeapplication/jsonمع طلبات POST
Idempotency-Keyنص فريد من عندكاختياري: يمنع تكرار الشراء لو أعدت إرسال الطلب

مثال سريع: شراء حساب تلجرام

curl -X POST https://glitchnum.duckdns.org/v1/telegram-accounts/order \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: order-1001" \ -d '{"country": "us"}'
import requests API = "https://glitchnum.duckdns.org/v1" H = {"X-API-Key": "YOUR_API_KEY"} # 1) الدول المتاحة وأسعارها print(requests.get(f"{API}/telegram-accounts/countries", headers=H).json()) # 2) شراء r = requests.post(f"{API}/telegram-accounts/order", headers=H, json={"country": "us"}) order = r.json()["data"] # 3) استعلم عن الكود print(requests.get(f"{API}/orders/{order['order_id']}", headers=H).json())
const API = "https://glitchnum.duckdns.org/v1"; const H = { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" }; const buy = await fetch(`${API}/telegram-accounts/order`, { method: "POST", headers: H, body: JSON.stringify({ country: "us" }) }); const { data } = await buy.json(); const st = await fetch(`${API}/orders/${data.order_id}`, { headers: H }); console.log(await st.json());

الحد الأقصى: 60 طلباً بالدقيقة لكل مفتاح.

🔒 تقدر تطلب من الدعم تحديد عناوين IP المسموح لها باستخدام مفتاحك، وتبقى محفوظة عند تجديد المفتاح. أي طلب من IP غير مسموح بيرجع 403 ip_not_allowed.

شكل الردود

عند النجاح success: true مع data. عند الفشل success: false مع error ورمز HTTP مناسب. الشراء الناجح يرجع 201.

{ "success": true, "data": { } }

الرصيد

GET/balance

رصيد حسابك الحالي بالدولار.

{ "success": true, "data": { "balance": 25.40, "currency": "USD" } }

خريطة الأقسام

كل قسم له مسار عرض ومسار شراء مستقلان.

القسمالعرضالشراء
🪪 SSNGET /misc/files/servicesPOST /misc/files/order
📧 الايميلاتGET /misc/emails/servicesPOST /misc/emails/order
🍎 Apple IDGET /misc/appleid/servicesPOST /misc/appleid/order
🇺🇸🇬🇧 سيرفر أمريكي بريطانيGET /numbers/usa/servicesPOST /numbers/usa/order
🇺🇸 سيرفر أمريكي 2GET /numbers/usa2/servicesPOST /numbers/usa2/order
🖥️ سيرفر أمريكي / مكالماتGET /numbers/standard/servicesPOST /numbers/standard/order
✈️ حسابات تلجرامGET /telegram-accounts/countriesPOST /telegram-accounts/order
📱 حسابات واتسابGET /whatsapp/servicesPOST /whatsapp/order

🪪 SSN (حسب الولاية)

الولايات المتوفر فيها مخزون:

GET/misc/files/states

المنتجات والأسعار في ولاية:

GET/misc/files/services?state=Texas
{ "success": true, "data": [ { "name": "Product", "price": 1.2, "stock": 14 } ] }

الشراء (تسليم فوري):

POST/misc/files/order
الحقلالنوعالوصف
statestringاسم الولاية (إجباري)
listing_namestringاسم المنتج (إجباري)

الرد يحوي type: إما content نصي، أو data_base64 لملف/صورة.

📧 الايميلات (حسب الفئة)

GET/misc/emails/categories

الفئات المتاحة.

GET/misc/emails/services?category_id=1

المنتجات والأسعار.

POST/misc/emails/order
الحقلالنوعالوصف
category_idintegerرقم الفئة (إجباري)
listing_namestringاسم المنتج (إجباري)

تسليم فوري، والرد بنفس شكل SSN.

🍎 Apple ID

المنتجات والأسعار المتوفرة (بدون ولايات أو فئات):

GET/misc/appleid/services
{ "success": true, "data": [ { "name": "Product", "price": 1.2, "stock": 14 } ] }

الشراء (تسليم فوري):

POST/misc/appleid/order
الحقلالنوعالوصف
listing_namestringاسم المنتج (إجباري)

الرد يحوي type: إما content نصي، أو data_base64 لملف/صورة، بنفس شكل SSN والايميلات، ويحوي أيضاً number: رقم التحقق المربوط بالحساب.

استلام كود التحقق: يصل على رقم الحساب ويُستلم من البوت (سجل الطلبات ← سجل Apple ID ← المنتج ← «استلام الكود»). أول استلامين مجانا لكل حساب، وبعدها رسوم صغيرة لكل استلام تُخصم من رصيدك.

🇺🇸🇬🇧 سيرفر أمريكي بريطاني + أرقام إيجار

عرض الخدمات مع أسعار المرة الواحدة والإيجار:

GET/numbers/usa/services?country=US&q=telegram
{ "success": true, "data": [ { "id": "abc", "name": "Telegram", "country": "US", "one_time": { "price": 0.6, "stock": 120 }, "rental": { "prices": { "3": 4, "7": 7, "14": 12, "30": 20 }, "stock": 30 } } ] }

country يقبل US أو UK.

POST/numbers/usa/order
الحقلالنوعالوصف
service_idstringمعرّف الخدمة (إجباري)
typestringone_time أو rental (إجباري)
durationintegerأيام الإيجار: 3 أو 7 أو 14 أو 30 (للإيجار فقط)
area_codestringرمز المنطقة: 3 أرقام بالظبط، لأرقام أمريكا فقط، اختياري

استعلم بـ GET /orders/{id} حتى يصل الكود. الإيجار يبقى active وتصلك كل الرسائل في messages.

{ "success": true, "data": { "order_id": 90231, "category": "numbers/usa", "status": "waiting_code", "price": 0.45, "number": "+15551234567", "code": null, "expires_at": null } }

🖥️ سيرفر أمريكي / 📞 مكالمات صوتية

خيارات الولايات وشركات الاتصال:

GET/numbers/standard/options

بحث عن خدمة:

GET/numbers/standard/services?mode=sms&q=telegram

سعر محدد قبل الشراء:

GET/numbers/standard/price?service_id=Telegram&mode=sms&state=Texas
POST/numbers/standard/order
الحقلالنوعالوصف
service_idstringاسم الخدمة (إجباري)
modestringsms أو voice، الافتراضي sms
statestringالولاية، اختياري (عشوائي افتراضياً)
carrierstringمفتاح الشركة من options، اختياري

هذا القسم يدعم الإلغاء POST /orders/{id}/cancel إذا لم يصل الكود وكان الإلغاء متاحاً، ويُعاد المبلغ تلقائياً.

{ "success": true, "data": { "order_id": 90231, "category": "numbers/standard", "status": "waiting_code", "price": 0.45, "number": "+15551234567", "code": null, "expires_at": null } }

✈️ حسابات تلجرام جاهزة

الدول المتوفرة وأسعارها:

GET/telegram-accounts/countries
{ "success": true, "data": [ { "country": "us", "name": "United States", "price": 0.45, "stock": 300 } ] }
POST/telegram-accounts/order
الحقلالنوعالوصف
countrystringرمز الدولة من القائمة (إجباري)

تحصل على الرقم، ثم استعلم بـ GET /orders/{id} حتى يظهر code.

{ "success": true, "data": { "order_id": 90231, "category": "telegram-accounts", "status": "waiting_code", "price": 0.45, "number": "+15551234567", "code": null, "expires_at": null } }

📱 حسابات واتساب

المنتجات مرتبة بمجموعات، بنفس ترتيب المتجر.

GET/whatsapp/services
{ "success": true, "data": [ { "group": "WhatsApp", "products": [ { "id": 7, "name": "Product name", "price": 1.5, "params": [] } ] } ] }

الشراء:

POST/whatsapp/order
الحقلالنوعالوصف
product_idintegerرقم المنتج (إجباري)
paramsobjectحقول المنتج المطلوبة params من القائمة، فقط إذا كان للمنتج حقول

الطلب بيدخل بحالة processing، وتصير completed عند الاكتمال. إذا تعذر التنفيذ بتصير refunded ويرجع المبلغ لرصيدك تلقائياً. تابع الحالة بـ GET /orders/{id}.

{ "success": true, "data": { "order_id": 90240, "category": "whatsapp", "status": "processing", "price": 1.5, "product": "Product name" } }

الطلبات

GET/orders/{id}

حالة طلب وتفاصيله (الرقم والكود والرسائل). يمكن استدعاؤه بشكل دوري كل بضع ثوانٍ.

GET/orders?page=1&per_page=20&category=&status=

سجل طلباتك.

POST/orders/{id}/cancel

إلغاء طلب (متاح لأرقام الجودة المتوسطة فقط).

الحالةالمعنى
waiting_codeبانتظار وصول الكود
activeإيجار فعّال
completedاكتمل وتم التسليم
processingقيد التنفيذ / التسليم
refundedتعذر التنفيذ وأُعيد المبلغ لرصيدك
reviewقيد المراجعة من الإدارة
cancelledأُلغي وأُعيد الرصيد
expiredانتهت المدة

الأخطاء

{ "success": false, "error": { "code": "insufficient_balance", "message": "Your balance is not enough" } }
HTTPالكودالمعنى
400invalid_paramsحقل ناقص أو غير صحيح
401invalid_api_keyالمفتاح غير صحيح
402insufficient_balanceالرصيد غير كافٍ
403account_bannedالحساب محظور
403ip_not_allowedالطلب من IP غير مسموح لهذا المفتاح
404not_foundالخدمة أو الطلب غير موجود
409out_of_stock / not_cancellable / area_code_unavailableغير متوفر / لا يمكن إلغاؤه / رمز المنطقة غير متوفر (لم يُخصم شيء)
429rate_limitedطلبات كثيرة
502purchase_failedتعذّر تنفيذ الطلب، لم يُخصم رصيدك
503service_unavailableالقسم متوقف مؤقتاً

🇺🇸 سيرفر أمريكي 2

أرقام أمريكية لمرة واحدة. عرض الخدمات: GET /numbers/usa2/services?q=google والشراء: POST /numbers/usa2/order مع service_id (إجباري) وarea_code (3 أرقام، اختياري).

استعلم بـ GET /orders/{id} حتى يصل الكود (waiting_code ← completed). إذا انتهت المدة بدون كود يرجع المبلغ تلقائياً والحالة expired. إذا ما توفر رقم بيرجع 409 no_numbers_available بدون خصم.

الأسعار المخصصة (خصم لحسابك)

إذا تم تفعيل خصم خاص لحسابك، تنعكس الأسعار المخفّضة تلقائياً في كل ردود العرض (.../services و /telegram-accounts/countries وغيرها) وعند الشراء، فلا تحتاج أي تعديل بكودك: السعر يلي بيرجع لك هو السعر يلي بينخصم من رصيدك فعلاً. وينطبق نفس الشيء على عروض التخفيض العامة (بنسبة مئوية) التي نعلنها: يُطبَّق الأعلى بين العرض وخصم حسابك. الخصم يُحدَّد لكل قسم على حدة:

القسممسار الشراء
🗓 أرقام شهرية (إيجار)POST /numbers/usa/order مع "type": "rental"
🇺🇸🇬🇧 سيرفر أمريكي بريطانيPOST /numbers/usa/order مع "type": "one_time"
🇺🇸 سيرفر أمريكي 2POST /numbers/usa2/order
🖥️ سيرفر أمريكي / 📞 مكالمات صوتيةPOST /numbers/standard/order
📧 الايميلات / 🪪 SSNPOST /misc/emails/order و POST /misc/files/order و POST /misc/appleid/order
✈️ تلجرام / 📱 واتسابPOST /telegram-accounts/order و POST /whatsapp/order

قيمة السعر بالطلب (price في /orders) هي المبلغ بعد الخصم، وأي استرداد بيرجع بنفس المبلغ المخصوم. لطلب خصم مخصص على قسم معين تواصل معنا (@VEXAR_SUPPORT).

الحصول على مفتاح API

بتنشئ مفتاحك وتجدّده بنفسك من البوت: افتح البوت واضغط زر API بالقائمة الرئيسية ثم «إنشاء مفتاح». بتلاقي مفتاحك دائماً هناك مع زر نسخ وزر تجديد، وتجديد المفتاح بيوقف القديم فوراً.

المفتاح مربوط برصيد حسابك بالبوت (تشحنه بنفس طرق الإيداع).