#P1689
POST /v2/charter/pledger
pledger: storePledgerCharter
این اندپوینت یک ضامن جدید (Pledger) را برای یک شعبه در جدول charter_pledgers ثبت میکند. در صورت موفقیت مقدار خاصی برنمیگرداند و تنها وضعیت 201 Created داده میشود.
URL:
/v2/charter/pledgerMethod: POST
Controller: CharterController@storePledgerCharter
Middleware: authWithJwt
Auth: JWT Required
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| branch | integer | yes | شناسه شعبهای که ضامن برای آن ثبت میشود |
| colleague_id | integer | yes | شناسه همکار ضامن |
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
| Column | Type | Description |
|---|---|---|
| id | integer | Primary Key (auto-increment) |
| branch | integer | شناسه شعبه |
| colleague_id | integer | شناسه همکار ضامن |
| status | tinyint | ۱ = فعال، ۰ = غیرفعال |
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