GOLDEN STORE API

واجهة واحدة.
تكامل بلا تعقيد.

استخدم Golden API لعرض الخدمات وإرسال الطلبات وتتبعها وقراءة رصيدك من متجرك أو خادمك. الطلبات عبر POST والاستجابات بصيغة JSON.

Endpointhttps://social.goldenstore1.com/api/v2

المصادقة

أرسل مفتاحك في ترويسة Authorization مع كل طلب. يمكنك إنشاء خمسة مفاتيح مستقلة وإلغاء أي مفتاح فورًا من مركز API.

cURLقائمة الخدمات

curl -X POST https://social.goldenstore1.com/api/v2 \
  -H "Authorization: Bearer gs_live_••••••••" \
  -d "action=services"

احتفظ بالمفتاح في الخادم فقطلا تضع المفتاح داخل تطبيق الجوال أو JavaScript المتصفح ولا تشاركه في المحادثات.

POST /orders

أنشئ طلبًا جديدًا باستخدام معرف الخدمة والرابط والكمية. يدعم المفتاح نفسه منع التكرار عبر Idempotency-Key.

الحقلالنوعالوصف

servicestringمعرف الخدمة من قائمة الخدمات

linkurlرابط الحساب أو المنشور المطلوب

quantityintegerالكمية ضمن الحد الأدنى والأعلى

webhookurlرابط اختياري لاستقبال التحديثات

RequestJSON

{
  "action": "add",
  "service": "GS-1842",
  "link": "https://example.com/post",
  "quantity": 1000
}

استخدم action=status مع رقم طلب GOLDEN. حدّث الحالة بوتيرة معقولة، ولا ترسل الطلب نفسه مرة أخرى إذا كانت حالته قيد التنفيذ.

pending processing completed partial / canceled

400بيانات الطلب غير صحيحة

401المفتاح مفقود أو غير صالح

422الكمية خارج حدود الخدمة

429تم تجاوز حد الطلبات