بني سير عمل ديال إعادة البيع باستعمال Zad Top HTTP API

Zad Top هو بوت مستقل فـ Telegram وHTTP API للبياعة، الحوانت، البانيلات، والبوتات المخصّصة. كيوفّر خدمات ديال Free Fire وPUBG Mobile وYalla Ludo وJawaker وiTunes وRazer Gold، بحال تفعيل الكودات، التحقق من الكارطات، البحث على اللاعب، تفعيل المخزون، وتصاور الطلبات.

هاد المستودع هو مركز عمومي للمطوّرين، وماشي الكود المصدري ديال البوت. التوثيق المباشر ديال الـ API كاين فـ api.zadtop.com/docs، ومعاه واجهة Swagger تفاعلية ووثيقة OpenAPI.

شنو تقدر تبني

مع Zad Top، تقدر تدير نظام ديال البياعة كيرسل الكودات الرقمية لـ IDs ديال اللاعبين، كيتحقق من الكارطات المدعومة قبل التفعيل، كيجيب السمية والجهة ديال اللاعب فـ اللعبة، وكيفعّل المنتجات من المخزون المحفوظ. وتقدر حتى تطلب تصويرة ديال طلب الحانوت من بعد التفعيل بنجاح.

• فعّل Free Fire وPUBG Mobile UC وYalla Ludo Diamonds وGold، وJawaker tokens.
• تحقق من كارطات Free Fire وPUBG وYalla Ludo Diamonds وiTunes وRazer Gold المدعومة.
• عمّر Razer Gold PIN فـ المحفظة ديالك.
• قلّب على السمية والجهة ديال اللاعب فـ اللعبة قبل ما تصرف الكود.
• خزّن الكودات فـ البوت وفعّل باكات المخزون بلا ما تدخل كل كود بوحدو.
• جيب تصويرة ديال الطلب باش تستعملها فـ نظام الحانوت.

وجد الولوج والتوثيق

باش تستعمل HTTP API، حلّ @ZadTopBot فـ Telegram واختار Subscription ومن بعد HTTP API. خاصك باقة مفعّلة وإضافة HTTP API. الـ README كيشير باللي الإضافة ثمنها 15 USDT لمدة 30 يوم. كاين حتى اشتراك منفصل ديال Code checking كيقدر يستعمل مسارات التحقق بوحدو.

من بعد ما تاخذ API key، صيفطو فـ header ديال X-API-Key مع كل طلب موثّق:

X-API-Key: pk_YOUR_KEY

إلا صنعت مفتاح جديد، المفتاح القديم كيتلغى، لذلك حدّث إعدادات التطبيق ديالك كل مرة كتبدّل بيانات الولوج. خلّي المفتاح فـ السيرفر ديالك وما تبيّنش فـ كود المتصفح ولا فـ المستودعات العمومية.

دير أول تفعيل فوري

المسار POST /v1/jobs/instant-redeem كيفعّل كود واحد ولا أكثر للاعب حسب ID ديالو. الطلب كيستعمل JSON وكيحتاج headers ديال API key وcontent type.

curl -sS -X POST https://api.zadtop.com/v1/jobs/instant-redeem \
  -H "X-API-Key: pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"2186053213","codes":["4233939008625064"],"game":"freefire"}'

القيمة ديال game فـ هاد المثال هي freefire. القيم الأخرى المدعومة هي pubg وludo وludogold وjawaker وrazer_recharge، وزيد عليهم القيم الخاصة بكل خدمة اللي موضّحة فـ توثيق الـ API.

طلبات التفعيل هي jobs. ملي كتوصل job للحالة done كيعني باللي المعالجة سالات، ولكن كل كود مرسَل عندو النتيجة ديالو success، وقد يكون عندو err_code إلا كان مناسب. ما تعتبرش job مكتملة دليل باللي جميع الكودات تفعّلو بنجاح.

تبع الـ jobs والنتائج

استعمل GET /v1/jobs/{id} باش تجيب الحالة والنتيجة ديال job. تقدر تزيد ?wait=25 باش تسنى حتى للمدة المحددة بلا ما تبدا polling مباشرة.

curl -sS "https://api.zadtop.com/v1/jobs/JOB_ID?wait=25" \
  -H "X-API-Key: pk_YOUR_KEY"

الربط العملي خاصو يخزّن ID ديال job، يطلب النتيجة ديالها، ومن بعد يفحص نتيجة كل كود بوحدو. عرض الكودات اللي نجحات واللي فشلات بشكل منفصل للزبون ولا فـ لوحة البياع.

تحقق من الكودات قبل التفعيل

المسار POST /v1/codes/check كيتحقق من حتى لـ 20 كارطة بلا ما يفعّلها. إلا كانت الدفعة كبيرة، استعمل POST /v1/jobs/code-check، اللي كيدعم حتى لـ 10,000 كارطة على شكل job.

النتائج المدعومة كتختلف حسب اللعبة. Free Fire يقدر يبيّن الحالات ديال غير مستعمل، مستعمل، ولا غير صالح، وقد يضمّ الباقة. PUBG يقدر يبيّن غير مستعمل، مستعمل، منتهي الصلاحية، ولا غير صالح، وقد يضمّ القيمة إلا كان الحانوت عارفها. يمكن التحقق من Yalla Ludo Diamonds، ولكن Gold ما عندهاش مسار تحقق. الكود ديال Gold إلا تصيفط لـ checker ديال Diamonds يقدر يتصرف، لذلك تأكد من نوع المنتج قبل ما تصيفطو.

فحوصات iTunes كترجع الرصيد بالدولار. أول قراءة من بعد مدة بلا استعمال تقدر تاخذ حتى لدقيقة. فحوصات Razer Gold كترجع الحالات ديال مباشر، مستعمل، ولا غير صالح بلا ما تصرف الـ PIN، ولكن الـ README كيحددها فـ خمسة طلبات لكل PIN.

قلّب على اللاعب قبل

قبل التفعيل، عيط على GET /v1/player/lookup باش تجيب السمية والجهة ديال اللاعب فـ اللعبة. هاد الشي كيساعدك ما تصيفطش كود صالح لـ ID ديال لاعب غالط.

curl -sS "https://api.zadtop.com/v1/player/lookup?player_id=2186053213&game=freefire" \
  -H "X-API-Key: pk_YOUR_KEY"

استعمل تفاصيل الهوية اللي رجعات ليك كخطوة ديال التأكيد فواجهة المستخدم ديالك. كايقول README بلي نتا مسؤول على معرّف اللاعب اللي كتختار، والكود الصالح كيتسجّل فالحساب اللي تبعث منّو أول تواصل ناجح مع المتجر.

استعمل استرداد المخزون

إلى كنت كتحافظ على مخزون فـ Zad Top، استعمل POST /v1/jobs/stock-redeem باش تسترد من المخزون المخزّن بلا ما تلصق الأكواد فكل طلب. المسار GET /v1/stock/summary كيعرض المخزون حسب اللعبة والحزمة.

curl -sS https://api.zadtop.com/v1/stock/summary \
  -H "X-API-Key: pk_YOUR_KEY"

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

اعتبارات خاصة بكل لعبة

• Free Fire: كيدعم الاسترداد والتحقق.
• PUBG Mobile: كيدعم استرداد UC والتحقق.
• Yalla Ludo: استعمل ludo أو ludogold حسب الحالة. الاسترداد كيتطلب tier. يمكن التحقق من Diamonds، ولكن ما يمكنش التحقق من Gold.
• Jawaker: كيدعم الاسترداد، ولكن ما كاينش تحقق مستقل من PIN ديالو اللي فيه 12 حرف.
• iTunes: كيدعم التحقق من الرصيد غير عبر الخدمة المذكورة؛ وأول طلب من بعد فترة ديال عدم النشاط يقدر ياخذ حتى دقيقة.
• Razer Gold: كيدعم التحقق من PIN بلا ما تصرفو. العملية razer_recharge كتشحن PIN فالمحفظة ديالك وكتطلب عنوان البريد الإلكتروني وكلمة السر. كلمة السر ما كتتخزنش.

زِد عمليات الحساب والمتجر

الـ API كيوفر حتى مسارات موجهة للحسابات والموزعين:

• GET /v1/me لمعلومات الحساب.
• GET /v1/quota لمعلومات الحصة المسموح بها.
• GET /v1/history لسجل العمليات.
• GET /v1/players للاعبين المحفوظين.
• POST /v1/order/screenshot لصورة طلب المتجر من بعد استرداد ناجح.

هاد المسارات تقدر تعاون فلوحة تحكم إدارية، بينما مسارات المهام والبحث تقدر تشغّل مسار طلب موجه للزبون.

فهم الحدود وتكاليف الاستعمال

كيقول README بلي الاسترداد كيكلف طلب واحد لكل كود، والتحقق كيكلف طلب واحد لكل بطاقة، والتحقق من Razer Gold كيكلف خمسة طلبات لكل PIN. البحث على لاعب كيكلف 0.25 طلب. رفض المتجر والفشل قبل ما ترجع النتيجة كيتحسبو حتى هما حسب قواعد الاستعمال الموثقة.

الحدود اليومية كترجع كتتصفر فنص الليل بتوقيت UTC، وكتتقاسمها الألعاب الموجودة فالباقة، وبوت Telegram، والـ API. الحسابات الجديدة كتاخذ 10 عمليات استرداد مجانية. أثمنة الباقات والتوفر ديالها يقدرو يتبدلو، لذلك تأكد من الشروط الحالية عبر البوت أو الموقع الرسمي قبل ما تبني مسار للفوترة.

المسار المقترح للدمج

1. جمع اللعبة ديال اللاعب، ومعرّف اللاعب، والمنتج، والكود.
2. عيّط لمسار البحث على اللاعب وبيّن الاسم والجهة اللي رجعات للتأكيد.
3. بالنسبة للمنتجات المدعومة، تحقّق من الكود قبل الاسترداد.
4. رسل مهمة استرداد فوري أو استرداد من المخزون.
5. دير الاستطلاع على /v1/jobs/{id} أو استعمل المعامل wait.
6. فحص الحالة العامة ديال المهمة وحقول success وerr_code ديال كل كود.
7. بيّن نتيجة واضحة للزبون، واطلب اختيارياً صورة ديال الطلب.

نصائح متقدمة فالتنفيذ

حمي بيانات الدخول

خزّن مفتاح الـ API فمتغيرات البيئة ديال الخادم أو فمدير الأسرار. تفادى تحطّو فالتطبيقات المحمولة، أو JavaScript ديال الواجهة، أو السجلات، أو لقطات الشاشة ديال الدعم.

صمّم للمعالجة غير المتزامنة

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

تحقق من توافق المنتجات والألعاب

استعمل تعيين واضح للمنتجات فالتطبيق ديالك باش ما يتبعثوش Diamonds وGold وUC ومنتجات أخرى بالخطأ للمسار أو أداة التحقق الغلط. هاد الشي مهم خصوصاً فـ Yalla Ludo، فين Gold ما عندوش تحقق، وقد يتصرف باستعمال طلب تحقق غير مناسب.

حسب حساب التأخير والحصص

خلّي وقت إضافي لقراءة رصيد iTunes وللمهام الجماعية. تتبع استعمال الحصة محلياً، خصوصاً فعمليات التحقق ديال Razer، حيث PIN واحد يقدر يستهلك خمسة طلبات. وحسب حتى الحصة اليومية المشتركة بين نشاط البوت والـ API.

الخلاصة

كتوفر Zad Top واجهة API مركزة على مسارات عمل موزعي الألعاب الرقمية وبطاقات الهدايا. بدا بالولوج للـ API وبالهيدر X-API-Key، وتحقق من هويات اللاعبين، واستعمل عمليات التحقق ملي تكون مدعومة، ورسل مهام الاسترداد، وقيّم نتيجة كل كود. باش تعرف تفاصيل المسارات والسلوك الحالي للخدمة، راجع مرجع HTML للـ API، وتوثيق Swagger، ومستودع GitHub ديال المشروع.

Zad Top خدمة مستقلة وما عندهاش علاقة بـ Garena أو Krafton أو Tencent أو Yalla Games أو Apple أو Razer أو Jawaker.