Service Usage in Controller Example

laravel_service_usage_controller.php

<?php

   /**
     * Requests a call from the sales team
     *
     * @method PUT
     * @param Request $request
     * @param int $userId
     * @param RequestPhoneCall\Service $requestCall
     *
     * @return Response
     */
    public function requestCall(Request $request, int $userId, RequestPhoneCall\Service $requestCall): Response
    {
        try {
            $payload = $request->json()->all();

            $responseData = $requestCall->execute(
                new RequestPhoneCall\Request(['user_id' => $userId], $payload)
            )->getData();

            Log::info('Request call successful', [
                'action'      => __METHOD__,
                'user_id'     => $userId,
                'phone'       => $payload['phone'],
                'description' => sprintf('Merchant: %s (%s) requested a call.', $responseData['user']['name'], $responseData['user']['id'])
            ]);

            return $this->ok([
                'onboarding' => $responseData['onboarding'],
            ]);
        } catch (ValidationException | BusinessException $e) {
            Log::error('Request call failed', [
                'action'        => __METHOD__,
                'user_id'       => $userId,
                'error_message' => $e->getMessage()
            ]);

            return $this->badRequest($e->getErrors());
        }
    }