#P1592
POST /v2/accounting/connections/update
Route Info
| Method | Endpoint | Controller |
| POST | /v2/accounting/connections/update | AccountingController@updateConnection |
شرح عملکرد (Functionality)
این متد برای ویرایش یک Connection موجود استفاده میشود. نوع عملیات وابسته به دو آرایه است:
items_add: آیتمهایی که باید به Connection اضافه شوندitems_remove: آیتمهایی که باید از Connection جدا شوند
برای هر آیتم، فیلد relationship در جدول مربوطه یا به مقدار connection_id آپدیت میشود یا null میگردد.
نوع هر آیتم، جدول مقصد را تعیین میکند:
pay,wage→ جدولpaysfitem→ جدولfactor_itemsfinancial_past→ جدولfinancial_pastscheck→ جدولcheck_operations
پارامترهای ورودی (JSON Body)
{
"connection_id": 42,
"items_add": [
{ "type": "pay", "id": 1001 },
{ "type": "check", "id": 55 },
{ "type": "fitem", "id": 990 }
],
"items_remove": [
{ "type": "financial_past", "id": 81 },
{ "type": "pay", "id": 402 }
]
}
فیلدهای اجباری:
connection_id(int)items_add(آرایه آیتمها)items_remove(آرایه آیتمها)
خروجی (Response)
موفق (Success)
{
"status": true,
"time": 1718450000
}
خطا (Error)
اینجا هیچ مدیریت خطا، اعتبارسنجی یا کنترل وجود ندارد. اگر:
connection_idاشتباه باشد،- آیتم حذفشونده قبلاً جدا شده باشد،
- آیتم افزودهشونده وجود نداشته باشد،
- نوع (
type) اشتباه ارسال شود،
باز هم متد بدون هیچ هشدار یا Exception، پاسخ موفق بازمیگرداند. (Silent Failure)