POST/v1/smm/orders

إنشاء طلب

ينشئ طلب SMM من خدمة موجودة في الكتالوج.

الصلاحية المطلوبة: smm.orderحد الطلبات: 10 rps

المعطيات

service_slugstringمطلوب

معرّف خدمة SMM (من GET /smm/services).

linkstringمطلوب

رابط الحساب أو المنشور المستهدف.

quantityintegerمطلوب

الكمية المطلوبة، ضمن حدَي الخدمة الأدنى والأقصى.

أمثلة الكود

curl -X POST "https://samaprime.com/api/v1/smm/orders" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"service_slug":"example","link":"example","quantity":1000}'

الاستجابة

→ 201
{
  "data": {
    "id": "cm_smmord_01J8Y2A3BBCCDD",
    "status": "placed",
    "quantity": 1000,
    "sell_usd": "3.5000",
    "provider_order_id": "panel_ord_998877"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

الأخطاء

الحالة	الرمز
404	`service_unavailable` لا توجد خدمة فعّالة بهذا المعرّف.
400	`quantity_out_of_range` الكمية خارج نطاق الحد الأدنى والأقصى للخدمة.
400	`invalid_link` الرابط لا يطابق منصة الخدمة المتوقعة.
422	`insufficient_balance` رصيد المحفظة أقل من تكلفة الطلب.
500	`provider_error` رفض لوحة SMM الطلب أو فشلت فيه — تم رد المبلغ.