توثيق API جواكر برو

نفس مسارات وطريقة ربط واجهة الموزعين في المتجر الأساسي.

أول خطوة

افتح «التكاملات» من لوحة التاجر وأنشئ مفتاح API. أرسل المفتاح في ترويسة api-token. غيّر عنوان الخدمة ومعرّف المنتج في ربطك الحالي. كل مسار GET يقبل POST بالمعاملات نفسها.

Base URL: https://api.jawaker-panel.mr-omegastore.shop

curl -H "api-token: YOUR_API_TOKEN" "https://api.jawaker-panel.mr-omegastore.shop/client/api/profile"

المسارات

GET /client/api/profileرصيد الحساب وهوية التاجر

GET /client/api/categoriesأقسام الكتالوج

GET /client/api/content/0محتوى القسم

GET /client/api/productsمنتج التوكنز والحدود المتاحة

GET /client/api/newOrder/1/paramsإنشاء طلب شحن

GET /client/api/checkالتحقق من طلبات محددة

GET /client/api/changeStateHistoryالتغييرات الحديثة لحالات الطلبات

تحميل OpenAPI JSON

مثال إرسال شحن

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

curl -G "https://api.jawaker-panel.mr-omegastore.shop/client/api/newOrder/1/params" \
  -H "api-token: YOUR_API_TOKEN" \
  --data-urlencode "qty=70000" \
  --data-urlencode "playerId=1200345999" \
  --data-urlencode "order_uuid=59ea2020-14c9-4c9a-a871-97cb34156d4f"

رد الطلب يحتوي order_id مستقلًا بصيغة JW-... وstatus بقيم accept / reject / wait. ابحث عنه لاحقًا عبر /client/api/check?orders=[JW-...] أو uuid=1.

Webhook والأمان

أضف رابط HTTPS عامًّا في «التكاملات». عند حسم الطلب يصل POST يحمل order_id, uuid, status, reply, player_id, player_name, player_level, player_image, execution_ms, quantity, updated_at. تحقّق من X-Jawaker-Signature بحساب HMAC-SHA256 على جسم JSON الخام باستخدام السر الذي يظهر عند حفظ الرابط. اعتمد X-Jawaker-Delivery لمنع معالجة الإشعار المكرر. يتم إرجاع الرصيد فقط عند رفض مؤكد، والنتيجة غير المؤكدة تظهر wait للمراجعة.