API كوينز FC للموزعين: أتمتة الطلبات من متجرك
باختصار
تتيح API الموزعين من SuperCoinsy لموقعك أو البوت الخاص بك الاطلاع على المخزون والأسعار، وإنشاء الطلبات ودفعها من رصيدك باليورو، ومتابعة حالتها، وإرسال الرسائل إلى فريقنا. تستخدم التفويض بالرمز (token)، وكل مستخدم API مرتبط بعنوان IP. يُفعَّل الوصول لحسابات الموزعين المعتمدة.
ما الذي يمكنك أتمتته
- المخزون - تحقق مما يمكننا تسليمه الآن، لكل منصة، قبل أن تعرض زر الشراء.
- الأسعار - اسحب سعر الموزع الحالي لكل منصة، ليبقى هامش ربحك حيث تريد.
- الطلبات - أنشئ طلباً وادفعه في استدعاء واحد. إذا لم يكفِ رصيدك، لا يُنشأ الطلب.
- الحالة - اعرض قائمة طلباتك أو تفاصيل طلب واحد، بما في ذلك أقصى وقت للتسليم.
- الرسائل - أضف رسالة إلى طلب، مثلاً لإرسال رموز احتياطية جديدة.
- الإلغاء - أرسل طلب إلغاء لطلب ما.
كيف يمر الطلب عبر API
1تحقق من المخزون والسعراستدعِ available-stock وprices قبل أن تأخذ المبلغ من عميلك.
2أنشئ الطلبأرسل الكمية بوحدة K، والمنصة، وبيانات دخول EA لعميلك مع رموز احتياطية جديدة. يمكنك إضافة رقم طلبك الخاص إن أردت.
3احفظ رقم الطلبيعيد الرد رقم طلب مثل R_QWERTY. كل الاستدعاءات اللاحقة تستخدمه.
4تابع الحالةراجع قائمة الطلبات أو تفاصيل الطلب على فترات معقولة واعرض الحالة لعميلك.
5تصرّف عند الحاجةإذا طلب فريقنا رموزاً احتياطية جديدة، أرسلها كرسالة في الطلب.
مثال على طلب (قيم تجريبية)
POST https://supercoinsy.com/uk/api/reseller/new-transaction
X-Authorization: <your 60-character token>
X-UserID: <your 6-character identifier>
Content-Type: application/json
{
"quantity": 150,
"platform": "pc",
"emailapp": "[email protected]",
"passapp": "customer-password",
"codesapp": "code1, code2, code3",
"userorderid": "SHOP-1042"
}كيف تحصل على الوصول
1احصل على موافقة لحساب الموزعقدّم طلبك في صفحة الموزعين.
2اطلب منا تفعيل APIراسل مديرنا على Discord (supercoinsy) أو على [email protected].
3أنشئ مستخدم APIفي لوحة الموزعين، أدخل عنوان IP لخادمك. ستحصل على رمز (token) ومعرّف قصير.
4احفظ الرمز بأمان وفعّل المستخدميظهر الرمز مرة واحدة فقط. يمكنك إيقاف مستخدم API أو حذفه في أي وقت.
أفضل الممارسات
- الكمية دائماً بوحدة K. أرسل 150 مقابل 150,000 كوينز. إرسال الرقم الكامل سينشئ طلباً أكبر بألف مرة.
- "ps" تعني كل أجهزة الكونسول. هناك قيمتان للمنصة: pc وps. طلبات Xbox تُرسل كـ ps.
- الرموز الاحتياطية تُستخدم مرة واحدة. أرسل دائماً رموزاً جديدة. الرموز المستخدمة لن تسمح لنا بالدخول، وسينتظر الطلب.
- راجع الحالة باعتدال. تحقق من الحالة كل بضع دقائق، وليس في حلقة متواصلة.
- اسحب الأسعار بانتظام. لا تثبّتها في كود متجرك.
- تعامل مع الرمز ككلمة مرور. استخدم مستخدم API واحداً لكل خادم، وإذا تسرّب رمز، أوقف ذلك المستخدم وأنشئ واحداً جديداً.
- احمِ بيانات عملائك. أرسل بيانات الدخول عبر HTTPS فقط ولا تحتفظ بها في سجلاتك.
المرجع الكامل لنقاط الوصول مع أمثلة الطلبات والردود: وثائق API الموزعين.
الأسئلة الشائعة
هل أحتاج إلى API للعمل معكم؟+
لا. كل ما تقوم به API يمكن تنفيذه يدوياً في لوحة الموزعين. الـ API للمتاجر التي تريد أتمتة طلباتها.
هل يوجد webhook لتغييرات الحالة؟+
ليس بعد. راجع قائمة الطلبات أو تفاصيل الطلب على فترات معقولة لترى تغييرات الحالة.
كيف أحصل على الوصول إلى API؟+
بعد الموافقة على حساب الموزع، اطلب من مديرنا على Discord أو بالبريد تفعيل الوصول إلى API. ثم أنشئ مستخدم API بعنوان IP لخادمك في لوحة الموزعين.
