تتيح لك واجهة برمجة تطبيقات Panel.Socialesale التفاعل مع موقعنا عن طريق إرسال طلب بسيط إلى خادمنا. هذه الخدمة مجانية تمامًا.

يمكنك أتمتة تقديم الطلبات، وتتبع حالة التسليم، ومتابعة رصيدك الحالي، والوصول إلى معلومات جميع خدماتنا برمجيًا. مثالية للموزعين الذين يديرون لوحاتهم الخاصة، والوكالات التي تدير عملاء متعددين، والمطورين الذين يبنون حلولاً مخصصة.

طريقة HTTP	POST
رابط API	https://panel.socialesale.com/api/v2
مفتاح API	احصل على مفتاح API من صفحة الحساب الخاصة بك
صيغة الاستجابة	JSON
مثال على كود PHP	https://panel.socialesale.com/example.txt

استخدم هذه الطريقة لتقديم طلب جديد لأي خدمة نشطة.

استجابة النجاح:

{
  "order":"23501"
}

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

عند التحقق من حالة الطلب، نطلب منك عدم القيام بذلك بشكل مفرط، وإلا فقد نضطر إلى تقييد طلباتك.

المعاملات	الأوصاف
api_token	رمز API الخاص بك
action	اسم الطريقة
order	معرف الطلب

طلبات Drip Feed: استخدم رقم الطلب المُرجَع من add. يصف status الطلب بالكامل. وأثناء تشغيله يُرجع In Progress. يمثل start_counter القيمة عند بداية الدفعة الأولى، ويمثل remains الكمية التي لم تُسلَّم بعد (الدفعات التي لم تبدأ بالإضافة إلى ما تبقى في الدفعات التي بدأت بالفعل). عند انتهاء الطلب يُرجع Completed أو Partial أو Cancelled، ويمثل remains الكمية النهائية غير المسلَّمة.

الإلغاء: الطلب الذي حالته Cancelling ليس نهائيًا بعد. استمر في التحقق من حالته حتى تتغير إلى Cancelled أو Partial، ولا تسترد لعميلك أي مبلغ إلا بناءً على هذه الإجابة النهائية.

استجابة النجاح:

{
  "status": "Completed",
  "start_counter": "600",
  "remains": "600"
}

يمكن إلغاء الطلب تلقائيًا عبر API إذا كان "عداد البدء" لا يزال فارغًا (يستغرق الإلغاء واسترداد المبلغ من 10 إلى 20 دقيقة). بمجرد تحديث "عداد البدء"، يكون العمل على الطلب قد بدأ، ولم يعد بالإمكان إلغاؤه تلقائيًا عبر API.

بالنسبة للطلبات التي بدأ العمل عليها، قد نتمكن من إلغائها يدويًا، ولكن سيتعين عليك طلب الإلغاء عن طريق فتح تذكرة دعم.

المعاملات	الأوصاف
api_token	رمز API الخاص بك
action	اسم الطريقة
order	معرف (معرفات) الطلب، مفصولة بفواصل، حتى 100 معرف

طلبات Drip Feed: يتم قبول طلب الإلغاء دائمًا. إذا لم تكن هناك دفعة نشطة، يتم إنهاء الطلب فورًا واسترداد قيمة الدفعات التي لم تبدأ قط. أما إذا كانت هناك دفعة نشطة، فيظهر الطلب بحالة Cancelling حتى تنتهي تلك الدفعة، ثم ينتهي بحالة Cancelled (لم يتم تسليم شيء) أو Partial. استخدم status لقراءة قيمة remains النهائية.

مثال على الاستجابة:

[
  {
    "order": 721,
    "cancel": 1,
    "message": "We are now attempting to cancel your order..."
  },
  {
    "order": 722,
    "errors": ["This order cannot be cancelled because its current status is COMPLETED."]
  }
]

اطلب إعادة تعبئة لطلب واحد أو لعدة طلبات في وقت واحد. تدعم ذلك الخدمات التي تحتوي على "refill": true فقط، وتتوفر إعادة التعبئة لفترة محدودة بعد اكتمال الطلب.

المعاملات	الأوصاف
api_token	رمز API الخاص بك
action	اسم الطريقة
order	معرف الطلب
orders	معرف (معرفات) الطلب، مفصولة بفواصل، حتى 100 معرف

مثال على الاستجابة:

{
  "refill": "1"
}

[
  {
    "order": 1,
    "refill": 1
  },
  {
    "order": 2,
    "refill": {
      "error": "Incorrect order ID"
    }
  }
]

تحقق من حالة طلب إعادة تعبئة واحد أو عدة طلبات في وقت واحد. Statuses: Pending, In progress, Completed, Rejected.

المعاملات	الأوصاف
api_token	رمز API الخاص بك
action	اسم الطريقة
refill	معرّف إعادة التعبئة
refills	معرّفات إعادة التعبئة (مفصولة بفواصل، حتى 100 معرّف)

مثال على الاستجابة:

{
  "status": "Completed"
}

[
  {
    "refill": 1,
    "status": "Completed"
  },
  {
    "refill": 2,
    "status": {
      "error": "Refill not found"
    }
  }
]

سيعيد هذا جميع الخدمات النشطة مع أسعارها ومعاملاتها المتاحة لحسابك. سيحتوي هذا على جميع المعلومات اللازمة لإعداد أو تحديد الأسعار تلقائيًا.

المعاملات	الأوصاف
api_token	رمز API الخاص بك
action	اسم الطريقة

مثال على الاستجابة:

[
  {
      "id": 101,
      "service_id": 1,
      "name": "Real & Active Followers - Best Server",
      "rate": "250.00",
      "min": "100",
      "max": "100000",
      "service": "Instagram Followers",
      "type": "default",
      "refill": true,
      "cancel": true,
      "dripfeed": false,
      "paragraphs": false,
      "desc": "0-3 Hours Start | Full Link | 20 Days Refill\r\nLink Format:\r\nhttps://www.instagram.com/official_social_sale/"
  },
  {
      "id": 107,
      "service_id": 1,
      "name": "Indian Mixed Followers",
      "rate": "150.00",
      "min": "200",
      "max": "10000",
      "service": "Instagram Followers",
      "type": "default",
      "refill": false,
      "cancel": false,
      "dripfeed": true,
      "paragraphs": false,
      "desc": "0-12 Hours Start | Full Link |\r\nLink Format:\r\nhttps://www.instagram.com/official_social_sale/"
  },
  {
      "id": 30067,
      "service_id": 1,
      "name": "Instagram Followers - Worldwide",
      "rate": "103.00",
      "min": "100",
      "max": "10000",
      "service": "Instagram Followers",
      "type": "default",
      "refill": false,
      "cancel": true,
      "dripfeed": false,
      "paragraphs": false,
      "desc": "10k/day\r\nMax - 55k\r\n8 Hours Start"
  }
]

يُستخدم للحصول على مقدار الرصيد المتاح في حسابك.

المعاملات	الأوصاف
api_token	رمز API الخاص بك
action	اسم الطريقة

مثال على الاستجابة:

{
  "balance": "100.78",
  "currency": "USD"
}