توثيق واجهة API الرسمية

تدعم منصة SMM Dragon معيار SMM API الشائع (Standard SMM Protocol v2) لتمكين الموزعين وأصحاب المنصات من ربط لوحاتهم وبرامجهم وتنفيذ ومتابعة الطلبات بشكل آلي وفوري.

نقطة نهاية الـ API (Endpoint)

POST https://tsetwep.shop/api/v2.php

جميع الطلبات ترسل عبر بروتوكول HTTP POST ويجب أن تتضمن معامل key الخاص بحسابك. الردود تُرجع دائماً بصيغة JSON.

1. جلب قائمة الخدمات (Service List)

المعامل	النوع	الوصف
`key`	مطلوب	مفتاح الـ API الخاص بك
`action`	مطلوب	القيمة: `services`

نموذج الاستجابة (JSON Response):

[ { "service": 1, "name": "Instagram Followers [High Quality]", "type": "Default", "category": "Instagram", "rate": "1.250", "min": 10, "max": 100000, "refill": true, "cancel": false } ]

2. إنشاء طلب جديد (Add Order)

المعامل	النوع	الوصف
`key`	مطلوب	مفتاح الـ API الخاص بك
`action`	مطلوب	القيمة: `add`
`service`	مطلوب	رقم تعريف الخدمة (Service ID)
`link`	مطلوب	رابط الحساب أو المنشور المستهدف
`quantity`	مطلوب	الكمية المطلوبة
`idempotency_key`	اختياري	مفتاح فريد لمنع تكرار الطلب في حال إعادة الإرسال

نموذج الاستجابة عند النجاح:

{ "order": 12458 }

3. فحص حالة الطلب (Order Status)

المعامل	النوع	الوصف
`key`	مطلوب	مفتاح الـ API الخاص بك
`action`	مطلوب	القيمة: `status`
`order`	مطلوب	رقم الطلب (أو معامل `orders` مفصولاً بفواصل لفحص عدة طلبات)

نموذج الاستجابة:

{ "charge": "2.500", "start_count": "1500", "status": "In progress", "remains": "500", "currency": "USD" }

4. فحص الرصيد (User Balance)

المعامل	النوع	الوصف
`key`	مطلوب	مفتاح الـ API الخاص بك
`action`	مطلوب	القيمة: `balance`

نموذج الاستجابة:

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