SMMEGY API V2

حوّل الطلب إلى اتصال.

واجهة POST JSON أو form-data لإدارة الطلبات من خادم موقعك. أنشئ حسابًا وأكّد البريد ثم أصدر مفتاحًا بصلاحيات مناسبة. لا تضع المفتاح في المتصفح أو رابط URL.

POST https://smmegy.com/api/v2
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

action	الحقول	الصلاحية
`services`	cursor (optional), limit (1–1000)	`services`
`balance`	—	`balance`
`add`	service, idempotency_key + order_form.fields; coupon optional	`orders:write`
`status`	order OR orders (comma-separated, maximum 100)	`orders:read`
`refill`	order, idempotency_key	`orders:actions`
`cancel`	order, idempotency_key	`orders:actions`
`refill_status`	order	`orders:actions`

اختر حقول نوع الخدمة

ابدأ بطلب services. كل خدمة تحتوي order_form يحدد إتاحة الطلب والحقول المطلوبة وحدودها ونوع التسعير. أرسل هذه الحقول مباشرة في جسم add، مثل comments أو username؛ لا تجمعها داخل options. ظهور الخدمة في الكتالوج لا يعني أنها متاحة للطلب: تحقق من order_form.orderable قبل الإرسال.

{
  "action": "services",
  "cursor": 0,
  "limit": 1000
}

// Example order_form for a Custom Comments service:
{
  "type": "custom_comments",
  "supported": true,
  "orderable": true,
  "blocked_reason": null,
  "quantity_mode": "comments",
  "rate_basis": "per_1000",
  "target": "link",
  "fields": {
    "link": {"type": "text", "required": true, "max_length": 2048},
    "comments": {"type": "textarea", "required": true, "max_length": 100000, "line_limit": 2000}
  },
  "drip": false
}

نوع الخدمة	حقول add	الكمية والتسعير
Default	`link, quantity`	الكمية التي تحددها، بسعر لكل 1000
Package	`link`	طلب واحد بسعر الباقة بالكامل
Custom Comments	`link, comments`	عدد سطور التعليقات غير الفارغة، بسعر لكل 1000
Custom Comments Package	`link, comments`	طلب واحد بسعر باقة التعليقات بالكامل
Comment Replies	`link, username, comments`	عدد سطور الردود غير الفارغة، بسعر لكل 1000
Comment Likes	`link, quantity, username`	الكمية التي تحددها، بسعر لكل 1000
Mentions Custom List	`link, usernames`	عدد أسماء المستخدمين غير الفارغة، بسعر لكل 1000
Mentions with Hashtags	`link, quantity, usernames, hashtags`	الكمية التي تحددها، بسعر لكل 1000
Mentions Hashtag	`link, quantity, hashtag`	الكمية التي تحددها، بسعر لكل 1000
Mentions User Followers	`link, quantity, username`	الكمية التي تحددها، بسعر لكل 1000
Mentions Media Likers	`link, quantity, media`	الكمية التي تحددها، بسعر لكل 1000
Invites from Groups	`link, quantity, groups`	الكمية التي تحددها، بسعر لكل 1000
Poll	`link, quantity, answer_number`	الكمية التي تحددها، بسعر لكل 1000
SEO	`link, quantity, keywords`	الكمية التي تحددها، بسعر لكل 1000
Web Traffic	`link, quantity, country, device, type_of_traffic`	الكمية التي تحددها، بسعر لكل 1000
Subscriptions	`username, min, max, posts, delay; old_posts/expiry optional`	حجز ميزانية محدودة: max × (posts + old_posts)

افصل التعليقات وأسماء المستخدمين والهاشتاجات والكلمات والمجموعات بسطر جديد. لا ترسل quantity للتعليقات المخصصة أو قائمة المنشن أو الباقات؛ الموقع يحسب الكمية المناسبة. username هو صاحب التعليق أو الحساب المطلوب حسب الخدمة؛ media هو رابط المنشور المصدر. رابط الهدف يجب أن يتوافق مع المنصة، وخدمات IPTV التي تطلب اسم مستخدم تقبله في link كما يوضح وصفها.

عندما يكون order_form.drip صحيحًا، تدعم الخدمة runs وعدد دقائق interval؛ الكمية المحجوزة والمحاسبة تساوي quantity × runs. استخدم fields.required وrequired_when وchoices وmin وmax لإنشاء نموذجك بدل افتراض نفس الحقول لجميع الخدمات. rate_basis=package يعني سعر الباقة بالكامل، وper_1000 يعني سعر كل ألف. rate في عملة الكتالوج، بينما charge النهائي بعملة المحفظة بعد الخصم والتحويل إن وُجدا.

خيارات زيارات المواقع

country يقبل كود البلد أو اسمه الكامل. device: ‏1 حاسوب، 2 أندرويد، 3 iOS، 4 موبايل متنوع، 5 موبايل وحاسوب. type_of_traffic: ‏1 بحث Google ويتطلب google_keyword، 2 إحالة مخصصة وتتطلب referring_url برابط HTTPS، 3 دون إحالة. أرسل الحقل الخاص بمصدر الزيارات المختار فقط.

إنشاء طلب بأمان

curl -X POST 'https://smmegy.com/api/v2' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"action":"add","service":123,"link":"https://www.instagram.com/p/YOUR_POST/","quantity":100,"idempotency_key":"my-site-order-12345"}'

أعد نفس المرجع والبيانات عند انقطاع الاتصال لتحصل على نفس الطلب. تغيير البيانات مع نفس المرجع مرفوض. تأكيد الطلب يحجز الرصيد، والتنفيذ يبدأ بعد قبول الطلب. القيم المالية نصوص عشرية والعملات تظهر صراحة في الرد.

مثال التعليقات المخصصة

{
  "action": "add",
  "service": 123,
  "link": "https://www.instagram.com/p/YOUR_POST/",
  "comments": "First comment\nSecond comment",
  "idempotency_key": "my-site-comments-12345"
}

مثال اشتراك تلقائي محدود

{
  "action": "add",
  "service": 456,
  "username": "YOUR_USERNAME",
  "min": 100,
  "max": 200,
  "posts": 10,
  "old_posts": 2,
  "delay": 5,
  "idempotency_key": "my-site-subscription-12345"
}

اختر service من النوع الموضح في المثال وحدود min وmax الخاصة به. posts مطلوب من 1 إلى 365، وposts + old_posts لا يزيد عن 365؛ لا تقبل اشتراكات مفتوحة. delay بالدقائق من choices في order_form. expiry اختياري بصيغة YYYY-MM-DD أو DD/MM/YYYY. المثال يحجز ميزانية 2400 وحدة بالسعر المعتمد؛ الميزانية لا تعني أن جميع الوحدات نُفذت. عند انتهاء الاشتراك تظهر settlement_review=true، ويبقى status=active والرصيد reserved حتى تؤكد الإدارة الكمية المنفذة بدليل التنفيذ؛ يُحصّل المنفذ ويُحرر الباقي مرة واحدة. هذه اشتراكات لمتابعة المنشورات، وتختلف عن تكرار الطلبات المجدول داخل حسابك.

الحدود والأخطاء

الافتراضي 60 اتصالًا بالدقيقة و10000 باليوم لكل مفتاح. HTTP 401 لمفتاح غير صالح، 403 للصلاحية، 422 للبيانات، 429 للحدود، و503 للصيانة. التعويض والإلغاء يعتمدان على قدرة الخدمة وحالة التنفيذ؛ طلب الإلغاء ليس تأكيدًا للاسترداد.

خدمات: استخدم آخر service كـcursor للصفحة التالية. status لا يكشف طلبات حساب آخر. لا ترسل تفاصيل الدفع أو كلمات مرور العملاء إلى API.

إدارة مفاتيحك