پرش به مطلب اصلی

فهرست پکیج‌ها

این API به شما امکان فهرست‌سازی تمام پکیج‌ها (نقش‌های ACL) تحت حساب ریسلر شما را می‌دهد. می‌توانید از پارامترهای page و per_page برای صفحه‌بندی نتایج استفاده کنید.

📍 لینک دسترسی

GET {base_url}/api/acl/package/list?page=1&per_page=10

🧾 هدرها

کلیدمقدار
Authorizationتوکن یا کلید دسترسی
Content-Typeapplication/json

📝 پارامترها

پارامترنوعاجباریتوضیحات
pageintegerخیرشماره صفحه برای دریافت. پیش‌فرض 1 است.
per_pageintegerخیرتعداد آیتم‌ها در هر صفحه. پیش‌فرض 10 است. حداکثر 1000.
package_idintegerخیرفیلتر بر اساس شناسه مشخص پکیج.
namestringخیرفیلتر بر اساس نام پکیج.
register_typestringخیرفیلتر بر اساس نوع ثبت‌نام (مثل: online,webservice).
typestringخیرفیلتر بر اساس نوع پکیج (مثل: user,reseller).
priceintegerخیرفیلتر بر اساس قیمت پکیج.
special_discintegerخیرفیلتر بر اساس تخفیف ویژه.
statusstringخیرفیلتر بر اساس وضعیت پکیج (مثل: active, inactive).

⚠️ مهم: برای حذف یک فیلتر از کوئری، آن را اصلاً در درخواست قرار ندهید. از ارسال آن با مقدار خالی یا null خودداری کنید.

✅ پاسخ موفق

{
"data": [
{
"acl_role_id": 123,
"acl_role_parent_id": 1,
"acl_role_name": "package name",
"price": 2000000,
"special_disc": 20,
"min_sms_charge": 0,
"time": 1740216700,
"user_id": 123,
"type": "normal",
"acl_type": "user",
"status": "active",
"priority": null,
"expire_time": null,
"acl_role_type_registration": "online",
"is_transferred": "0",
"election": "0",
"updated_at": "2025-02-22 09:31:40",
"updated_at_man": null
},
{
"acl_role_id": 123,
"acl_role_parent_id": 1,
"acl_role_name": "package name",
"price": 2000000,
"special_disc": 20,
"min_sms_charge": 0,
"time": 1740216700,
"user_id": 123,
"type": "normal",
"acl_type": "user",
"status": "active",
"priority": null,
"expire_time": null,
"acl_role_type_registration": "online",
"is_transferred": "0",
"election": "0",
"updated_at": "2025-02-22 09:31:40",
"updated_at_man": null
}
],
"meta": {
"current_page": 1,
"from": 1,
"last_page": 62,
"path": "https://baseurl/api/acl/package/list",
"per_page": 2,
"to": 1,
"total": 62,
"status": true,
"message": "انجام شد",
"message_code": "200-1"
}
}

❌ پاسخ خطا — توکن نامعتبر یا منقضی (401)

{
"data": null,
"meta": {
"status": false,
"message": "اطلاعات وارد شده صحیح نمی باشد",
"message_parameters": [],
"message_code": "400-1",
"errors": {}
}
}

🧪 نمونه درخواست

curl --location '{base_url}/api/acl/package/list?page=1&per_page=10&package_id=1234' \
--header 'Content-Type: application/json' \
--header 'Authorization: Your Apikey/Token'