# POST /v2/charter/pledger # pledger: storePledgerCharter این اندپوینت یک ضامن جدید (Pledger) را برای یک شعبه در جدول `charter_pledgers` ثبت می‌کند. در صورت موفقیت مقدار خاصی برنمی‌گرداند و تنها وضعیت **201 Created** داده می‌شود.
**URL:** `/v2/charter/pledger`
**Method:** POST
**Controller:** CharterController@storePledgerCharter
**Middleware:** authWithJwt
**Auth:** JWT Required
## Request Body
FieldTypeRequiredDescription
branchintegeryesشناسه شعبه‌ای که ضامن برای آن ثبت می‌شود
colleague\_idintegeryesشناسه همکار ضامن
## Controller Logic ``` public function storePledgerCharter(Request $request) { try { $insert = [ 'branch' => $request->get('branch'), 'colleague_id' => $request->colleague_id, ]; DB::table('charter_pledgers')->insert($insert); return response('', 201); } catch (Exception $exception) { return response()->json([ "message" => $exception->getMessage(), "trace" => $exception->getTrace() ], 400); } } ``` ## Table: charter\_pledgers
ColumnTypeDescription
idintegerPrimary Key (auto-increment)
branchintegerشناسه شعبه
colleague\_idintegerشناسه همکار ضامن
statustinyint۱ = فعال، ۰ = غیرفعال
## Success Response ``` Status: 201 Created Body: (empty) ``` ## Error Response ``` Status: 400 Bad Request { "message": "SQLSTATE[23000]: ...", "trace": [...] } ``` ## Flowchart
Validate JWT
↓
Read: branch, colleague_id
↓
DB Insert → charter_pledgers
↓
Insert OK?
↓
Yes → return 201
↓
No → return 400 with message + trace