# POST /v2/accounting/connections/list

<div id="bkmrk-" style="direction: rtl; font-family: Vazir, Tahoma; text-align: justify; line-height: 1.9;"></div>### Route Info

<div id="bkmrk-method-endpoint-cont" style="direction: rtl; font-family: Vazir, Tahoma; text-align: justify; line-height: 1.9;"><table border="1" style="width: 100%; border-collapse: collapse; text-align: center;"><tbody><tr style="background: #f4f4f4; font-weight: bold;"><td style="padding: 10px;">Method</td><td style="padding: 10px;">Endpoint</td><td style="padding: 10px;">Controller</td></tr><tr><td style="direction: ltr; padding: 10px;">POST</td><td style="direction: ltr; padding: 10px;">/v2/accounting/connections/list</td><td style="direction: ltr; padding: 10px;">AccountingController@listConnection</td></tr></tbody></table>

</div>### شرح عملکرد (Functionality)

این مسیر برای **دریافت لیست Connections فعال** استفاده می‌شود. امکان اعمال دو نوع فیلتر ورودی وجود دارد:

<div id="bkmrk-%D9%81%DB%8C%D9%84%D8%AA%D8%B1-%D8%A8%D8%B1-%D8%A7%D8%B3%D8%A7%D8%B3-%D9%85%D9%82%D8%AF%D8%A7%D8%B1-" style="direction: rtl; font-family: Vazir, Tahoma; text-align: justify; line-height: 1.9;">- فیلتر بر اساس مقدار `serial` (فیلد `search`)
- فیلتر بر اساس شناسه `object` (فیلد `id`)

</div>پس از اعمال فیلترها، فقط رکوردهایی با `status = 1` بازگردانده می‌شوند. در مرحله بعد، برای هر Connection یک ساختار خروجی شامل id، شماره سریال محاسبه‌شده و عنوان تولید می‌شود.

شماره سریال نهایی با افزودن `1000` به مقدار اصلی تولید می‌شود.

<div id="bkmrk--1" style="direction: rtl; font-family: Vazir, Tahoma; text-align: justify; line-height: 1.9;"></div>### پارامترهای ورودی (JSON Body)

همه پارامترها اختیاری هستند.

```
{
  "search": "123",     // اختیاری - جستجو بر اساس serial
  "id": "45"           // اختیاری - فیلتر بر اساس object id
}
```

<div id="bkmrk--2" style="direction: rtl; font-family: Vazir, Tahoma; text-align: justify; line-height: 1.9;"></div>### خروجی (Response)

#### موفق (Success)

```
{
  "status": true,
  "time": 1718450000,
  "data": [
    {
      "id": 12,
      "serial": 1123,
      "title": "ارتباط 1123"
    },
    ...
  ]
}
```

<div id="bkmrk--3" style="direction: rtl; font-family: Vazir, Tahoma; text-align: justify; line-height: 1.9;"></div>### خطاها (Errors)

این مسیر مدیریت خطای اختصاصی ندارد.

<div id="bkmrk-%D8%AF%D8%B1-%D8%B5%D9%88%D8%B1%D8%AA-%D8%B9%D8%AF%D9%85-%D9%88%D8%AC%D9%88%D8%AF-%D9%87%DB%8C%DA%86" style="direction: rtl; font-family: Vazir, Tahoma; text-align: justify; line-height: 1.9;">- در صورت عدم وجود هیچ Connection، مقدار `data` آرایه خالی خواهد بود.
- در صورت بروز خطای دیتابیس، پاسخ خطای عمومی سرور (5xx) برگردانده می‌شود.

</div>