PandaStore API

Verification API v2.0 — التوثيق الرسمي

البدء السريع

3 خطوات فقط لربط حسابك والبدء في استخدام API:

1
تسجيل الدخول عبر تيليجرام استخدم زر تسجيل الدخول الرسمي الخاص بتيليجرام (Telegram Login Widget) في موقعك.
2
ربط الحساب عبر API قم بإرسال بيانات المستخدم (ID والاسم) إلى نقطة الربط للحصول على مفتاح API.
3
تحقق من المستخدمين استخدم مفتاح API للتحقق من الأجهزة ومنع التكرار (POST /api/verify).

إدارة المفاتيح

POST/api/key/generate

توليد مفتاح API بعد استقبال بيانات تسجيل الدخول من تيليجرام في السيرفر الخاص بك
المعامل النوع الوصف
telegram_data object بيانات المصادقة الواردة من ويدجت تيليجرام (id, first_name, auth_date, hash)
الاستجابة:
200 {"success": true, "api_key": "panda_abc123..."}

POST/api/key/revoke

إلغاء مفتاح API
المعامل النوع الوصف
api_key string المفتاح المراد إلغاؤه

التحقق من الأجهزة

POST/api/verify

التحقق من بصمة الجهاز — هل المستخدم يستخدم أكثر من حساب؟
المعامل النوع الوصف
user_id int معرف المستخدم في تيليجرام
fingerprint string بصمة الجهاز (SHA-256، 64 حرف)
api_key string مفتاح API (أو عبر header X-API-Key)
الاستجابة:
200 {"success": true, "blocked": false}
200 {"success": true, "blocked": true, "duplicate_of": 789}

رموز الخطأ

الرمز الوصف
400 طلب غير صالح — بيانات ناقصة أو JSON غير صحيح
401 غير مصرح — مفتاح API غير صالح أو مفقود
403 ممنوع — الحساب غير مربوط أو المستخدم غير معروف
404 غير موجود — الرمز أو المفتاح غير موجود
429 تجاوز الحد — حد الطلبات (60/دقيقة)
413 حمولة كبيرة — الحد الأقصى 8KB

أمثلة الكود

🐍 Python
📗 Node.js
# PandaStore API — Python Example
import requests

BASE_URL = "https://verifyfp.pandastore.store"
API_KEY  = "panda_your_key_here"

# الخطوة 1: استقبال بيانات تيليجرام وتوليد مفتاح API
telegram_auth_data = {
    "id": 123456,
    "first_name": "User",
    "auth_date": 1710000000,
    "hash": "abc123def..."
}

r1 = requests.post(f"{BASE_URL}/api/key/generate", json={
    "telegram_data": telegram_auth_data
})
API_KEY = r1.json()["api_key"]
print("API Key:", API_KEY)

# الخطوة 3: التحقق من بصمة الجهاز
result = requests.post(f"{BASE_URL}/api/verify", json={
    "user_id": 123456789,
    "fingerprint": "a1b2c3...",  # SHA-256 hash (64 chars)
    "api_key": API_KEY
})

if result.json()["blocked"]:
    print("⚠️ حساب مكرر!")
else:
    print("✅ حساب جديد")