اربط موقعك أو بوتك بخدماتنا: مفتاح واحد، واستدعاء مخصص لكل قسم.
واجهة برمجية للتجار: اربط موقعك أو بوتك بخدماتنا. لكل قسم استدعاء لعرض خدماته وآخر للشراء. كل الردود JSON عبر HTTPS، والرصيد المستخدم هو رصيد حسابك في البوت (تشحنه بنفس طرق الإيداع).
كل المسارات في هذه الصفحة تُلحق بهذا الرابط. مثال: GET https://glitchnum.duckdns.org/v1/balance مع الهيدر X-API-Key: YOUR_API_KEY.
أرسل مفتاحك مع كل طلب. المفتاح سري، ويظهر لك دائماً من زر API في البوت (مع نسخ وتجديد).
| Header | القيمة | ملاحظة |
|---|---|---|
X-API-Key | YOUR_API_KEY | إجباري في كل طلب |
Content-Type | application/json | مع طلبات POST |
Idempotency-Key | نص فريد من عندك | اختياري: يمنع تكرار الشراء لو أعدت إرسال الطلب |
الحد الأقصى: 60 طلباً بالدقيقة لكل مفتاح.
🔒 تقدر تطلب من الدعم تحديد عناوين IP المسموح لها باستخدام مفتاحك، وتبقى محفوظة عند تجديد المفتاح. أي طلب من IP غير مسموح بيرجع 403 ip_not_allowed.
عند النجاح success: true مع data. عند الفشل success: false مع error ورمز HTTP مناسب. الشراء الناجح يرجع 201.
رصيد حسابك الحالي بالدولار.
كل قسم له مسار عرض ومسار شراء مستقلان.
| القسم | العرض | الشراء |
|---|---|---|
| 🪪 SSN | GET /misc/files/services | POST /misc/files/order |
| 📧 الايميلات | GET /misc/emails/services | POST /misc/emails/order |
| 🍎 Apple ID | GET /misc/appleid/services | POST /misc/appleid/order |
| 🇺🇸🇬🇧 سيرفر أمريكي بريطاني | GET /numbers/usa/services | POST /numbers/usa/order |
| 🇺🇸 سيرفر أمريكي 2 | GET /numbers/usa2/services | POST /numbers/usa2/order |
| 🖥️ سيرفر أمريكي / مكالمات | GET /numbers/standard/services | POST /numbers/standard/order |
| ✈️ حسابات تلجرام | GET /telegram-accounts/countries | POST /telegram-accounts/order |
| 📱 حسابات واتساب | GET /whatsapp/services | POST /whatsapp/order |
الولايات المتوفر فيها مخزون:
المنتجات والأسعار في ولاية:
الشراء (تسليم فوري):
| الحقل | النوع | الوصف |
|---|---|---|
state | string | اسم الولاية (إجباري) |
listing_name | string | اسم المنتج (إجباري) |
الرد يحوي type: إما content نصي، أو data_base64 لملف/صورة.
الفئات المتاحة.
المنتجات والأسعار.
| الحقل | النوع | الوصف |
|---|---|---|
category_id | integer | رقم الفئة (إجباري) |
listing_name | string | اسم المنتج (إجباري) |
تسليم فوري، والرد بنفس شكل SSN.
المنتجات والأسعار المتوفرة (بدون ولايات أو فئات):
الشراء (تسليم فوري):
| الحقل | النوع | الوصف |
|---|---|---|
listing_name | string | اسم المنتج (إجباري) |
الرد يحوي type: إما content نصي، أو data_base64 لملف/صورة، بنفس شكل SSN والايميلات، ويحوي أيضاً number: رقم التحقق المربوط بالحساب.
استلام كود التحقق: يصل على رقم الحساب ويُستلم من البوت (سجل الطلبات ← سجل Apple ID ← المنتج ← «استلام الكود»). أول استلامين مجانا لكل حساب، وبعدها رسوم صغيرة لكل استلام تُخصم من رصيدك.
عرض الخدمات مع أسعار المرة الواحدة والإيجار:
country يقبل US أو UK.
| الحقل | النوع | الوصف |
|---|---|---|
service_id | string | معرّف الخدمة (إجباري) |
type | string | one_time أو rental (إجباري) |
duration | integer | أيام الإيجار: 3 أو 7 أو 14 أو 30 (للإيجار فقط) |
area_code | string | رمز المنطقة: 3 أرقام بالظبط، لأرقام أمريكا فقط، اختياري |
استعلم بـ GET /orders/{id} حتى يصل الكود. الإيجار يبقى active وتصلك كل الرسائل في messages.
خيارات الولايات وشركات الاتصال:
بحث عن خدمة:
سعر محدد قبل الشراء:
| الحقل | النوع | الوصف |
|---|---|---|
service_id | string | اسم الخدمة (إجباري) |
mode | string | sms أو voice، الافتراضي sms |
state | string | الولاية، اختياري (عشوائي افتراضياً) |
carrier | string | مفتاح الشركة من options، اختياري |
هذا القسم يدعم الإلغاء POST /orders/{id}/cancel إذا لم يصل الكود وكان الإلغاء متاحاً، ويُعاد المبلغ تلقائياً.
الدول المتوفرة وأسعارها:
| الحقل | النوع | الوصف |
|---|---|---|
country | string | رمز الدولة من القائمة (إجباري) |
تحصل على الرقم، ثم استعلم بـ GET /orders/{id} حتى يظهر code.
المنتجات مرتبة بمجموعات، بنفس ترتيب المتجر.
الشراء:
| الحقل | النوع | الوصف |
|---|---|---|
product_id | integer | رقم المنتج (إجباري) |
params | object | حقول المنتج المطلوبة params من القائمة، فقط إذا كان للمنتج حقول |
الطلب بيدخل بحالة processing، وتصير completed عند الاكتمال. إذا تعذر التنفيذ بتصير refunded ويرجع المبلغ لرصيدك تلقائياً. تابع الحالة بـ GET /orders/{id}.
حالة طلب وتفاصيله (الرقم والكود والرسائل). يمكن استدعاؤه بشكل دوري كل بضع ثوانٍ.
سجل طلباتك.
إلغاء طلب (متاح لأرقام الجودة المتوسطة فقط).
| الحالة | المعنى |
|---|---|
waiting_code | بانتظار وصول الكود |
active | إيجار فعّال |
completed | اكتمل وتم التسليم |
processing | قيد التنفيذ / التسليم |
refunded | تعذر التنفيذ وأُعيد المبلغ لرصيدك |
review | قيد المراجعة من الإدارة |
cancelled | أُلغي وأُعيد الرصيد |
expired | انتهت المدة |
| HTTP | الكود | المعنى |
|---|---|---|
| 400 | invalid_params | حقل ناقص أو غير صحيح |
| 401 | invalid_api_key | المفتاح غير صحيح |
| 402 | insufficient_balance | الرصيد غير كافٍ |
| 403 | account_banned | الحساب محظور |
| 403 | ip_not_allowed | الطلب من IP غير مسموح لهذا المفتاح |
| 404 | not_found | الخدمة أو الطلب غير موجود |
| 409 | out_of_stock / not_cancellable / area_code_unavailable | غير متوفر / لا يمكن إلغاؤه / رمز المنطقة غير متوفر (لم يُخصم شيء) |
| 429 | rate_limited | طلبات كثيرة |
| 502 | purchase_failed | تعذّر تنفيذ الطلب، لم يُخصم رصيدك |
| 503 | service_unavailable | القسم متوقف مؤقتاً |
أرقام أمريكية لمرة واحدة. عرض الخدمات: 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" |
| 🇺🇸 سيرفر أمريكي 2 | POST /numbers/usa2/order |
| 🖥️ سيرفر أمريكي / 📞 مكالمات صوتية | POST /numbers/standard/order |
| 📧 الايميلات / 🪪 SSN | POST /misc/emails/order و POST /misc/files/order و POST /misc/appleid/order |
| ✈️ تلجرام / 📱 واتساب | POST /telegram-accounts/order و POST /whatsapp/order |
قيمة السعر بالطلب (price في /orders) هي المبلغ بعد الخصم، وأي استرداد بيرجع بنفس المبلغ المخصوم. لطلب خصم مخصص على قسم معين تواصل معنا (@VEXAR_SUPPORT).
بتنشئ مفتاحك وتجدّده بنفسك من البوت: افتح البوت واضغط زر API بالقائمة الرئيسية ثم «إنشاء مفتاح». بتلاقي مفتاحك دائماً هناك مع زر نسخ وزر تجديد، وتجديد المفتاح بيوقف القديم فوراً.
المفتاح مربوط برصيد حسابك بالبوت (تشحنه بنفس طرق الإيداع).