API v1 Documentation

ربط واجهة الـ API للموزعين والتجار

اربط متجرك أو موقعك تلقائياً مع سيرفرات فولومارت وأرسل الطلبات برمجياً بأسعار الجملة.

HTTP MethodPOST

API Endpoint URLhttps://follow-mart.com/api/v1

Response FormatJSON

POST1. استعراض قائمة الخدمات (Services List)

action: services

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

// الطلب (Request Parameters)

key: "YOUR_API_KEY"

action: "services"

// الاستجابة المتوقعة (Sample JSON Response)

[
  {
    "service": "instagram-followers-arab",
    "name": "متابعين انستقرام عرب حقيقيين",
    "type": "Default",
    "category": "انستقرام",
    "rate": "24.99",
    "min": 100,
    "max": 25000,
    "refill": true
  }
]

POST2. إنشاء وتنفيذ طلب جديد (Add Order)

action: add

// الطلب (Parameters)

key: "YOUR_API_KEY"

action: "add"

service: "instagram-followers-arab"

link: "https://instagram.com/username أو @username"

quantity: 1000

// الاستجابة (Response)

{
  "order": "FM-20261012-104921"
}

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

action: status

key: "YOUR_API_KEY"

action: "status"

order: "FM-20261012-104921"

{
  "charge": "24.99",
  "start_count": "1520",
  "status": "In progress",
  "remains": "0",
  "currency": "SAR"
}