🎮 ZarPlay DAPI

✅ پاسخ موفق (۲۰۰)

{
  "success": true,
  "message": "Login successful",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user": {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "username": "john_doe",
      "vault": "26" <-- موجودی کیف پول (واحد T)
    }
  }
}

❌ خطاها

// ۴۰۰ – پارامترهای
{ "success": false, "error": "Required parameters are missing.", "details": { "missing_parameters": ["username", "password"] } }
// ۴۰۱ – اطلاعات نادرست
{ "success": false, "error": "Invalid username or password." }

✅ پاسخ موفق

{
  "success": true,
  "message": "Registration successful",
  "data": {
    "token": "...",
    "user": { "uuid": "...", "username": "john_doe", "vault": "26" }
  }
}

❌ خطاها

// ۴۰۰ – کاربر تکراری
{ "success": false, "error": "User with this username already exists" }
// ۴۰۹ – خطای سرور
{ "success": false, "error": "Server Error" }

✅ پاسخ موفق

{ "success": true, "data": { "vault": "26" } }

❌ خطا

{ "success": false, "error": "User not found" }

✅ پاسخ موفق

{ "success": true, "data": { "owns": true } }

✅ پاسخ موفق (۲۰۰)

{
  "success": true,
  "data": {
    "total": 45,
    "page": 1,
    "limit": 20,
    "data": [
      {
        "uuid": "item-123",
        "name": "پتال سلامت",
        "description": "۵۰ جان به بازیکن اضافه می‌کند",
        "price": 100,
        "currency": "in_game"
      }
    ]
  }
}

✅ پاسخ موفق

{ "success": true, "message": "Purchase successful", "data": { "item_name": "پتال سلامت", "quantity": 1 } }

❌ خطاها

// ۴۰۰ – موجودی ناکافی
{ "success": false, "error": "Insufficient in-game currency" }
// ۴۰۰ – آیتم نامعتبر
{ "success": false, "error": "Invalid item" }

✅ پاسخ موفق

{
  "success": true,
  "data": {
    "total": 5,
    "page": 1,
    "limit": 20,
    "data": [
      {
        "item_uuid": "item-123",
        "name": "پتال سلامت",
        "description": "۵۰ جان به بازیکن اضافه می‌کند",
        "quantity": 3,
        "purchased_at": "2025-03-27T12:00:00Z"
      }
    ]
  }
}

✅ پاسخ موفق

{ "success": true, "data": { "balance": 1250 } }

✅ پاسخ موفق

{ "success": true, "message": "Wallet topped up (simulated)", "data": { "new_balance": 1500 } }

✅ پاسخ موفق

{ "success": true, "message": "Achievement unlocked" }

❌ خطا

{ "success": false, "error": "Achievement not found" }

✅ پاسخ موفق

{
  "success": true,
  "data": {
    "total": 10,
    "page": 1,
    "limit": 20,
    "data": [
      {
        "achievement_id": "kill_100",
        "name": "قاتل حرفه‌ای",
        "description": "۱۰۰ دشمن را بکش",
        "points": 50,
        "unlocked": true,
        "unlocked_at": "2025-03-27T10:00:00Z"
      }
    ]
  }
}

✅ پاسخ موفق

{ "success": true, "message": "Score submitted" }

✅ پاسخ موفق

{
  "success": true,
  "data": {
    "total": 500,
    "page": 1,
    "limit": 100,
    "data": [
      { "username": "john_doe", "score": 9999, "updated_at": "2025-03-27T11:00:00Z" },
      { "username": "jane_doe", "score": 8500, "updated_at": "2025-03-27T10:30:00Z" }
    ]
  }
}

✅ پاسخ موفق

{
  "success": true,
  "data": [
    { "uuid": "dlc-123", "name": "بسته الحاقی: دنیای یخزده", "description": "مناطق جدید و دشمنان یخی", "price": 9.99 }
  ]
}

✅ پاسخ موفق

{ "success": true, "message": "DLC purchased", "data": { "dlc_name": "بسته الحاقی: دنیای یخزده" } }

❌ خطاها

// ۴۰۰ – عدم مالکیت بازی پایه
{ "success": false, "error": "You must own the base game to purchase this DLC" }

✅ پاسخ موفق

{ "success": true, "data": { "download_url": "https://zarplay.ir/api/files/dlc/path/to/file.zip" } }

❌ خطاها

// ۴۰۳ – عدم دسترسی
{ "success": false, "error": "You don't own this DLC" }

✅ پاسخ موفق

{ "success": true, "message": "Session created", "data": { "session_id": "room123" } }

✅ پاسخ موفق

{ "success": true, "message": "Joined session" }

❌ خطاها

// ۴۰۰ – جلسه پر است
{ "success": false, "error": "Session is full" }
// ۴۰۴ – جلسه یافت نشد
{ "success": false, "error": "Session not found" }

✅ پاسخ موفق

{
  "success": true,
  "data": {
    "total": 4,
    "page": 1,
    "limit": 20,
    "data": [
      { "username": "john_doe", "joined_at": "2025-03-27T12:00:00Z" },
      { "username": "jane_doe", "joined_at": "2025-03-27T12:01:00Z" }
    ]
  }
}

✅ پاسخ موفق

{ "success": true, "message": "Game save uploaded successfully" }

❌ خطاها

// ۴۰۰ – حجم فایل بیش از ۴MB
{ "success": false, "error": "File size exceeds the limit of 4 MB" }

✅ پاسخ موفق

فایل با Content-Type application/octet-stream و نام save_{user_uuid}_{game_uuid}.dat برگردانده می‌شود.

❌ خطاها

{ "success": false, "error": "No saved game found" }