أرسل مفتاح الـ API الخاص بحسابك باسم key في كل طلب.
يدعم السيرفر كلاً من POST (موصى بها) أو GET.
الأسعار بالليرة السورية (SYP) مع تطبيق السعر والخصم المخصص لحسابك تلقائياً.
جلب كافة الخدمات والباقات المتوفرة مع أرقام المعرّفات (Service IDs) والأسعار المخصصة لحسابك بالليرة السورية.
| اسم المعلمة | القيمة | النوع | الحالة | الشرح |
|---|---|---|---|---|
| key | مفتاحك الخاص | نص (string) | إجباري | مفتاح الربط (API Key) الخاص بحسابك في الموقع. |
| action | services | نص (string) | إجباري | القيمة الثابتة: services. |
يعود لك كائن JSON يحتوي قائمة الخدمات، ولكل خدمة: رقم الخدمة (service)، اسم الخدمة (name)، الفئة (category)، وسعر البيع لحسابك (price / rate).
جلب قائمة الفئات والتصنيفات (مثل سيرياتيل، MTN، بطاقات ألعاب، إلخ) لتنظيم الخدمات لديك.
| اسم المعلمة | القيمة | النوع | الحالة | الشرح |
|---|---|---|---|---|
| key | مفتاحك الخاص | نص (string) | إجباري | مفتاح الـ API الخاص بحسابك. |
| action | categories | نص (string) | إجباري | القيمة الثابتة: categories. |
إرسال وتمرير طلب شحن مباشر لرقم أو حساب مستهدف. يتم الخصم فوراً من رصيدك وبدء التنفيذ الفوري.
| اسم المعلمة | القيمة | النوع | الحالة | الشرح |
|---|---|---|---|---|
| key | مفتاحك الخاص | نص | إجباري | مفتاح الـ API الخاص بحسابك. |
| action | add | نص | إجباري | القيمة الثابتة: add. |
| service | رقم الخدمة | رقم (integer) | إجباري | رقم الخدمة المستخرج من قائمة الخدمات (Service ID). |
| target | الرقم المستهدف | نص / رقم | إجباري | رقم الهاتف المحمول، رقم الخط الأرضي، أو ID الحساب المستهدف شحنه. |
| quantity | الكمية | رقم (integer) | اختياري | الكمية المطلوبة (الافتراضي 1، مهم للخدمات الحرة مثل الوحدات). |
في حال النجاح، يرجع لك: status = success ومعه رقم الطلب في النظام order ورقم الفاتورة order_number.
في حال الفشل (مثل نقص الرصيد)، يرجع: status = fail مع سبب الخطأ في error.
الاستعلام عن حالة طلب شحن تم إرساله مسبقاً (سواء طلب مفرد أو عدة طلبات معاً أو كافة الطلبات).
| اسم المعلمة | القيمة | النوع | الحالة | الشرح |
|---|---|---|---|---|
| key | مفتاحك الخاص | نص | إجباري | مفتاح الـ API الخاص بحسابك. |
| action | status | نص | إجباري | القيمة الثابتة: status. |
| order | رقم الطلب الفردي | رقم / نص | اختياري | رقم الطلب المستعلم عنه (أو أرسل all لجلب كل طلباتك). |
| orders | أرقام طلبات متعددة | نص مفصول بفاصلة | اختياري | لفحص عدة طلبات دفعة واحدة مثل: 101,102,103. |
| كود الحالة | الحالة بالعربية | المعنى والتفاصيل |
|---|---|---|
| pending | قيد الانتظار | تم استلام الطلب وبانتظار بدء المعالجة في السيرفر. |
| processing | قيد المعالجة | الطلب يجري تعبئته وتنفيذه حالياً لدى مزود الخدمة. |
| completed | مكتمل | تم شحن وتعبئة الرصيد بنجاح كامل للرقم المستهدف. |
| failed | فاشل | فشل تنفيذ الطلب لدى المزود وتمت إعادة الرصيد فوراً إلى محفظتك. |
| refunded | مرتجع | تم إرجاع الطلب واسترداد قيمته للمحفظة. |
جلب كامل سجل طلباتك التي تمت من خلال حسابك، مع إمكانية الفلترة بحسب الحالة أو الخدمة أو البحث برقم معين.
| اسم المعلمة | القيمة | النوع | الحالة | الشرح |
|---|---|---|---|---|
| key | مفتاحك الخاص | نص | إجباري | مفتاح الـ API الخاص بحسابك. |
| action | orders | نص | إجباري | القيمة الثابتة: orders. |
| status | الحالة المراد جلبها | نص | اختياري | فلترة الطلبات (مثل completed أو pending أو all لجلب الكل). |
| service | رقم الخدمة | رقم | اختياري | فلترة وجلب طلبات خدمة محددة فقط. |
| search | نص البحث | نص / رقم | اختياري | بحث برقم الهاتف المستهدف أو برقم الطلب. |
| limit | عدد السجلات | رقم | اختياري | عدد الطلبات المعادة (الافتراضي 100، الحد الأقصى 500). |
معرفة رصيدك المالي المتاح حالياً في حسابك والمخصص لتنفيذ الطلبات.
| اسم المعلمة | القيمة | النوع | الحالة | الشرح |
|---|---|---|---|---|
| key | مفتاحك الخاص | نص | إجباري | مفتاح الـ API الخاص بحسابك. |
| action | balance | نص | إجباري | القيمة الثابتة: balance. |
يعود لك كائن JSON يحتوي رصيدك الحالي بالليرة السورية: balance و currency: "SYP".