نقطة المصادقة والحساب

يحمل كل طلب رأسًا واحدًا. و GET /account هي النقطة التي تناديها لتثبت أن المفتاح يعمل، ولتقرأ رصيد المحفظة الذي تُخصم منه طلباتك، ولتتأكّد أن الحساب مفعّل قبل بدء أي تشغيل دفعي.

كيف يُصادَق على الطلب

يحمل رأس Authorization بيان اعتماد Bearer على شكل معرّف مفتاح وسرّ تفصل بينهما نقطة. معرّف المفتاح يختار الحساب، ويُفحص السرّ بمقارنة HMAC؛ والفحص الفاشل يردّ 401 بالكود MISSING_API_KEY أو INVALID_API_KEY قبل تشغيل المسار نفسه. ولا شيء آخر يُفحص — لا كوكي، ولا رمز CSRF، ولا رأس origin.

قوائم عناوين IP المسموح بها

يمكن تثبيت المفتاح على مجموعة من عناوين المصدر. وما دامت تلك القائمة غير فارغة، يُرفض أي طلب من عنوان آخر بالكود IP_NOT_ALLOWED و HTTP 403 — قبل تطبيق حدود المعدل وقبل أي استعلام عن المحفظة — فلا يمكن استخدام بيان اعتماد مسروق خارج بنيتك التحتية. والقائمة الفارغة تعني أن المفتاح يعمل من أي مكان.

حالة الحساب

شرط واحد على مستوى الحساب يقطع الطريق على كل نقطة نهاية: الحساب المجمَّد يردّ ACCOUNT_FROZEN بالحالة HTTP 403. ولا يزول تلقائيًا، فارفعه إلى شخص مسؤول بدل إعادة المحاولة في حلقة.

تدوير المفاتيح

تُنشأ المفاتيح وتُحذف من صفحة API Access في لوحة الموزّع. ويُعرض السرّ مرة واحدة عند الإنشاء، فالتدوير هو إنشاء ثم نشر ثم حذف، لا تعديل في المكان. ولا تنتهي صلاحية بيانات الاعتماد من تلقاء نفسها، ما يعني أن جدول التدوير متروك لك.

GET

/account

جلب معلومات الحساب

يعرض معلومات الحساب بالتفصيل، ومنها رصيد المحفظة وحالة الحساب وتاريخ الإنشاء.

حدّ المعدل60 طلباً / 60 ثانية لكل حساب

الطلب

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

مثال استجابة

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

أرسل طلبًا حقيقيًا من هذه الصفحة

الصق مفتاح API لمناداة هذه النقاط مباشرةً. يبقى المفتاح في تبويب المتصفّح هذا ولا يُرسل إلا إلى الواجهة البرمجية نفسها.

Enter your API key to use the interactive playground. Get your API key

اختر نقطة نهاية

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

جديد على المنصة؟ ابدأ من نظرة عامة على واجهة شحن الألعاب للموزّعين، أو اقرأ نظرة عامة على برنامج موزّعي SHOP2TOPUP لمعرفة كيفية عمل حساب الشريك.