FoxiGrow
ابدأ الآن
ابدأ الآن
في هذه الصفحة

توثيق API

إصدار API: v2

يوفّر FoxiGrow واجهة API v2 قياسية لتتمكن اللوحات والبوتات والموزّعون من دمج مصدرنا المعتمد على أشخاص حقيقيين في تطبيقاتهم. تُنشر الطلبات كمهام ويكملها أكثر من 650,000 من الأشخاص الحقيقيين الموثّقين — ويُتحقّق من كل عملية إرسال قبل احتسابها. يغطّي هذا التوثيق جميع نقاط النهاية المتاحة وطريقة استخدامها. البروتوكول متوافق مع تكاملات لوحات SMM v2 القائمة، فيمكنك الربط دون أي تعديل.

عنوان API

https://order.foxigrow.com/api/v2

يجب إرسال جميع الطلبات إلى هذا العنوان عبر طريقة POST أو GET.

المصادقة

تتطلب جميع طلبات API المصادقة باستخدام مفتاح API الخاص بك. يمكنك العثور على مفتاح API في إعدادات حسابك. قم بتضمين معلمة key في كل طلب.

POST https://order.foxigrow.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

تنسيق الاستجابة

يتم إرجاع جميع الاستجابات بتنسيق JSON. تُرجع الطلبات الناجحة البيانات المطلوبة، بينما تُرجع الأخطاء كائن خطأ مع الوصف.

نقاط النهاية API

الحصول على الخدمات

يُرجع قائمة بجميع الخدمات المتاحة مع تفاصيلها بما في ذلك الأسعار والكميات الدنيا والقصوى.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "services"
// مثال على الاستجابة
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

الحصول على الرصيد

يُرجع رصيد حسابك الحالي والعملة.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "balance"
// مثال على الاستجابة
{
  "balance": "100.84292",
  "currency": "USD"
}

إضافة طلب

إنشاء طلب جديد لخدمة. تعتمد المعلمات المطلوبة على نوع الخدمة.

النوع الافتراضي

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "add"
  • service - معرف الخدمة (مطلوب)
  • link - عنوان URL المستهدف (مطلوب)
  • quantity - كمية الطلب (مطلوب)

نوع الباقة

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "add"
  • service - معرف الخدمة (مطلوب)
  • link - عنوان URL المستهدف (مطلوب)

نوع التعليقات المخصصة

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "add"
  • service - معرف الخدمة (مطلوب)
  • link - عنوان URL المستهدف (مطلوب)
  • comments - التعليقات مفصولة بسطر جديد (مطلوب)
// مثال على الاستجابة
{
  "order": 23501
}

حالة الطلب

الحصول على حالة طلب واحد أو أكثر. يمكنك الاستعلام عن طلب واحد أو عدة طلبات في وقت واحد.

طلب واحد

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "status"
  • order - معرف الطلب (مطلوب)

طلبات متعددة (حتى 100)

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "status"
  • orders - معرفات الطلبات مفصولة بفاصلة (مطلوب)
// مثال على الاستجابة
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

إنشاء إعادة تعبئة

طلب إعادة تعبئة لطلب. متاح فقط للخدمات التي تدعم إعادة التعبئة.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "refill"
  • order - معرف الطلب (مطلوب)
// مثال على الاستجابة
{
  "refill": "1"
}

حالة إعادة التعبئة

التحقق من حالة طلب إعادة التعبئة.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "refill_status"
  • refill - معرف إعادة التعبئة (مطلوب)
// مثال على الاستجابة
{
  "status": "Completed"
}

حالات الطلب

  • Pending - الطلب في انتظار المعالجة
  • Processing - الطلب قيد التحضير
  • In progress - الطلب قيد التنفيذ حالياً
  • Completed - تم إكمال الطلب بنجاح
  • Partial - تم إكمال الطلب جزئياً (تم استرداد المبلغ المتبقي)
  • Canceled - تم إلغاء الطلب

معالجة الأخطاء

عند حدوث خطأ، يُرجع API كائن JSON مع حقل error يصف المشكلة.

// مثال على استجابة الخطأ
{
  "error": "Invalid API key"
}

حدود المعدل

لضمان جودة الخدمة، تنطبق حدود المعدل التالية:

  • 5 طلبات في الثانية
  • 100 طلب في الدقيقة
  • 1000 طلب في الساعة

الدعم

إذا كانت لديك أي أسئلة حول API، يرجى الاتصال بفريق الدعم لدينا:

Telegram: @FoxigrowBD