Laravel l5-swagger api-docs.json file not found

You need to add the Info as mentioned in the error.

A simple, yet powerful solution would be adding it to AppHttpController::class:

<?php

namespace AppHttpControllers;

use IlluminateFoundationAuthAccessAuthorizesRequests;
use IlluminateFoundationValidationValidatesRequests;
use IlluminateRoutingController as BaseController;
use OpenApiAttributes as OA;



#[OAInfo(title: "My First API", version: "0.1",)]

class Controller extends BaseController
{
    use AuthorizesRequests, ValidatesRequests;
}

This will ensure that the Info is added to all your requests as well.

You can then easily add your PathItems, as en example for AppHttpControllerApiHeartbeatController::class:

<?php

namespace AppHttpControllersApi;

use AppHttpControllersController;
use OpenApiAttributes as OA;

class HeartbeatController extends Controller
{
    #[OAGet(
        path: '/heartbeat',
        responses: [
            new OAResponse(response: '200', description: 'API is running', content: new OAJsonContent(example: ['status' => 'ok', 'message' => 'API is running']))
        ],
    )]
    public function __invoke(): IlluminateHttpJsonResponse
    {
        return response()->json([
            'status' => 'ok',
            'message' => 'API is running',
        ]);
    }
}