# نکات مهم درباره API پنل 3x-ui

## توجه

API پنل 3x-ui ممکن است در نسخه‌های مختلف متفاوت باشد. در صورت بروز مشکل در اتصال به پنل، لطفاً موارد زیر را بررسی کنید:

## بررسی API پنل

1. **بررسی endpoint ورود**: 
   - معمولاً: `/login`
   - ممکن است: `/api/login` یا `/xui/login`

2. **بررسی endpoint دریافت inbound ها**:
   - معمولاً: `/panel/inbound/list`
   - ممکن است: `/api/inbound/list`

3. **بررسی endpoint به‌روزرسانی inbound**:
   - معمولاً: `/panel/inbound/update/{id}`
   - ممکن است: `/api/inbound/update/{id}`

## تست اتصال

از فایل `test_api.php` برای تست اتصال به پنل استفاده کنید.

## تنظیمات API

اگر API پنل شما متفاوت است، فایل `api/XrayAPI.php` را ویرایش کنید و endpoint ها را تغییر دهید.

## ساختار پاسخ API

پنل 3x-ui معمولاً پاسخ‌های JSON با ساختار زیر برمی‌گرداند:

```json
{
  "success": true,
  "msg": "پیام",
  "obj": { ... }
}
```

## احراز هویت

برخی نسخه‌های پنل از cookie-based authentication استفاده می‌کنند و برخی از token-based. 
کلاس `XrayAPI` از هر دو روش پشتیبانی می‌کند.

## مشکلات رایج

1. **خطای 401 Unauthorized**: 
   - نام کاربری یا رمز عبور اشتباه است
   - یا API endpoint متفاوت است

2. **خطای 404 Not Found**:
   - URL پنل اشتباه است
   - یا endpoint API متفاوت است

3. **خطای CORS**:
   - اگر پنل روی دامنه دیگری است، ممکن است نیاز به تنظیمات CORS باشد

## راه‌حل

در صورت بروز مشکل:
1. فایل `test_api.php` را اجرا کنید
2. لاگ خطاها را بررسی کنید
3. با استفاده از ابزارهای توسعه‌دهنده مرورگر، درخواست‌های API را بررسی کنید
4. endpoint های صحیح را در `api/XrayAPI.php` به‌روزرسانی کنید
