#P1689

POST /v2/charter/pledger

این اندپوینت یک ضامن جدید (Pledger) را برای یک شعبه در جدول charter_pledgers ثبت می‌کند. در صورت موفقیت مقدار خاصی برنمی‌گرداند و تنها وضعیت 201 Created داده می‌شود.

URL: /v2/charter/pledger

Method: 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