File: /var/www/api_matriculas/app/Http/Controllers/Signapis/SignapisSigninController.php
<?php
namespace App\Http\Controllers\Signapis;
use App\Http\Controllers\Controller;
use App\Services\Signapis\SignapisService;
use Illuminate\Http\Request;
use Exception;
class SignapisSigninController extends Controller
{
protected SignapisService $signapis;
public function __construct(SignapisService $signapis)
{
$this->signapis = $signapis;
}
// ======================================
// 🔹 DOCUMENT SIGNING (Individual)
// ======================================
/**
* @OA\Post(
* path="/signapis/documents/signatories/{signatoryId}/sign",
* summary="Firmar un documento individual (signatario)",
* tags={"SignApis/Documents"},
* @OA\Parameter(name="signatoryId", in="path", required=true,
* @OA\Schema(type="string"), example="b1f2bb89-70a0-4f4c-b783-058c5afe3e80"),
* @OA\RequestBody(
* required=true,
* @OA\JsonContent(
* @OA\Property(property="signatureType", type="integer", enum={1,2,3}, example=1),
* @OA\Property(property="signatureText", type="string", example="John Doe"),
* @OA\Property(property="signatureImage", type="string", example="base64string"),
* @OA\Property(property="geolocation", type="string", example="-33.4489,-70.6693"),
* @OA\Property(property="geolocationReference", type="string", example="Santiago, Chile")
* )
* ),
* @OA\Response(response=200, description="Documento firmado exitosamente")
* )
*/
public function signDocument(Request $request, $signatoryId)
{
try {
$data = $this->signapis->signDocument($signatoryId, $request->all());
return response()->json(['data' => $data, 'message' => 'ok', 'code' => 200]);
} catch (Exception $e) {
return response()->json(['error' => $e->getMessage()], $e->getCode() ?: 500);
}
}
}