توثيق VEXAR API

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

مقدمة

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

https://vexarnum.duckdns.org/v1

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

أرسل مفتاحك مع كل طلب. المفتاح سري ويُحفظ لدينا مشفراً، ويُعرض لك مرة واحدة فقط عند إنشائه.

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

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

curl -X POST https://vexarnum.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://vexarnum.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())

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

🔒 تقدر تحدد عناوين IP المسموح لها باستخدام مفتاحك من قسم «الحصول على مفتاح API». أي طلب من 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" } }

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

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

القسم	العرض	الشراء
🆔 هويات	`GET /misc/hobbies/services`	`POST /misc/hobbies/order`
📁 الملفات	`GET /misc/files/services`	`POST /misc/files/order`
📧 الايميلات	`GET /misc/emails/services`	`POST /misc/emails/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`

🆔 هويات

اسم هذا القسم بيجي من إعدادات الموقع (ملف config)، والمسار التقني بيضل /misc/hobbies.

عرض الخدمات:

GET/misc/hobbies/services

{ "success": true, "data": [ { "id": 12, "name": "Service name", "name_ar": "اسم الخدمة", "price": 4.5, "description": "..." } ] }

الشراء:

POST/misc/hobbies/order

الحقل	النوع	الوصف
`service_id`	integer	رقم الخدمة (إجباري)

تُسلَّم الخدمة فوراً. تجد التفاصيل في description، وإذا كانت الصورة هي المنتج بتجي بالرد داخل data_base64 (JPEG).

{ "success": true, "data": { "order_id": 90232, "category": "hobbies", "status": "completed", "price": 3.0, "service": "Service name", "contact": "@VEXAR_0" } }

📁 الملفات (حسب الولاية)

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

GET/misc/files/states

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

GET/misc/files/services?state=Texas

{ "success": true, "data": [ { "name": "Product", "price": 1.2, "stock": 14 } ] }

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

POST/misc/files/order

الحقل	النوع	الوصف
`state`	string	اسم الولاية (إجباري)
`listing_name`	string	اسم المنتج (إجباري)

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

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

GET/misc/emails/categories

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

GET/misc/emails/services?category_id=1

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

POST/misc/emails/order

الحقل	النوع	الوصف
`category_id`	integer	رقم الفئة (إجباري)
`listing_name`	string	اسم المنتج (إجباري)

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

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

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

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_id`	string	معرّف الخدمة (إجباري)
`type`	string	`one_time` أو `rental` (إجباري)
`duration`	integer	أيام الإيجار: 3 أو 7 أو 14 أو 30 (للإيجار فقط)
`area_code`	string	رمز المنطقة: 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_id`	string	اسم الخدمة (إجباري)
`mode`	string	`sms` أو `voice`، الافتراضي sms
`state`	string	الولاية، اختياري (عشوائي افتراضياً)
`carrier`	string	مفتاح الشركة من 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

الحقل	النوع	الوصف
`country`	string	رمز الدولة من القائمة (إجباري)

تحصل على الرقم، ثم استعلم بـ 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_id`	integer	رقم المنتج (إجباري)
`params`	object	حقول المنتج المطلوبة `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	الكود	المعنى
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`	القسم متوقف مؤقتاً

🇺🇸 سيرفر أمريكي 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"`
🇺🇸 سيرفر أمريكي 2	`POST /numbers/usa2/order`
🖥️ سيرفر أمريكي / 📞 مكالمات صوتية	`POST /numbers/standard/order`
📧 الايميلات / 📁 الملفات	`POST /misc/emails/order` و `POST /misc/files/order`
✈️ تلجرام / 📱 واتساب	`POST /telegram-accounts/order` و `POST /whatsapp/order`

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

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

لكل حساب مفتاح واحد بيضل ظاهر لك، تنسخه بأي وقت، وتقدر تبدله بمفتاح جديد، وتحميه بتحديد عناوين IP. المفتاح مربوط برصيد حسابك (نفس رصيد البوت والموقع).

🔑 افتح الموقع لإنشاء مفتاحك

أرقام التفعيل والحسابات الرقمية في مكان واحد

تسليم تلقائي

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

واجهة API للموزعين

عربي و English

الخدمات

شرائح E-Sim مع رقم هاتف

أرقام أوتو

ملفات وإيميلات

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

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

هويات

بوت مخصص لمشروعك

كيف يعمل

ابدأ

اشحن رصيدك

اختر الخدمة

استلم طلبك

الدفع والمزايا