solidtime/routes/api.php

<?php

declare(strict_types=1);

use App\Http\Controllers\Api\V1\ClientController;
use App\Http\Controllers\Api\V1\ImportController;
use App\Http\Controllers\Api\V1\OrganizationController;
use App\Http\Controllers\Api\V1\ProjectController;
use App\Http\Controllers\Api\V1\TagController;
use App\Http\Controllers\Api\V1\TimeEntryController;
use App\Http\Controllers\Api\V1\UserController;
use Illuminate\Support\Facades\Route;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

/*
|--------------------------------------------------------------------------
| API Routes
|--------------------------------------------------------------------------
|
| Here is where you can register API routes for your application. These
| routes are loaded by the RouteServiceProvider and all of them will
| be assigned to the "api" middleware group. Make something great!
|
*/

Route::middleware('auth:api')->prefix('v1')->name('v1.')->group(static function () {
    // Organization routes
    Route::name('organizations.')->group(static function () {
        Route::get('/organizations/{organization}', [OrganizationController::class, 'show'])->name('show');
        Route::put('/organizations/{organization}', [OrganizationController::class, 'update'])->name('update');
    });

    // User routes
    Route::name('users.')->group(static function () {
        Route::get('/organizations/{organization}/users', [UserController::class, 'index'])->name('index');
        Route::post('/organizations/{organization}/users/{user}/invite-placeholder', [UserController::class, 'invitePlaceholder'])->name('invite-placeholder');
    });

    // Project routes
    Route::name('projects.')->group(static function () {
        Route::get('/organizations/{organization}/projects', [ProjectController::class, 'index'])->name('index');
        Route::get('/organizations/{organization}/projects/{project}', [ProjectController::class, 'show'])->name('show');
        Route::post('/organizations/{organization}/projects', [ProjectController::class, 'store'])->name('store');
        Route::put('/organizations/{organization}/projects/{project}', [ProjectController::class, 'update'])->name('update');
        Route::delete('/organizations/{organization}/projects/{project}', [ProjectController::class, 'destroy'])->name('destroy');
    });

    // Time entry routes
    Route::name('time-entries.')->group(static function () {
        Route::get('/organizations/{organization}/time-entries', [TimeEntryController::class, 'index'])->name('index');
        Route::post('/organizations/{organization}/time-entries', [TimeEntryController::class, 'store'])->name('store');
        Route::put('/organizations/{organization}/time-entries/{timeEntry}', [TimeEntryController::class, 'update'])->name('update');
        Route::delete('/organizations/{organization}/time-entries/{timeEntry}', [TimeEntryController::class, 'destroy'])->name('destroy');
    });

    // Tag routes
    Route::name('tags.')->group(static function () {
        Route::get('/organizations/{organization}/tags', [TagController::class, 'index'])->name('index');
        Route::post('/organizations/{organization}/tags', [TagController::class, 'store'])->name('store');
        Route::put('/organizations/{organization}/tags/{tag}', [TagController::class, 'update'])->name('update');
        Route::delete('/organizations/{organization}/tags/{tag}', [TagController::class, 'destroy'])->name('destroy');
    });

    // Client routes
    Route::name('clients.')->group(static function () {
        Route::get('/organizations/{organization}/clients', [ClientController::class, 'index'])->name('index');
        Route::post('/organizations/{organization}/clients', [ClientController::class, 'store'])->name('store');
        Route::put('/organizations/{organization}/clients/{client}', [ClientController::class, 'update'])->name('update');
        Route::delete('/organizations/{organization}/clients/{client}', [ClientController::class, 'destroy'])->name('destroy');
    });

    // Import routes
    Route::name('import.')->group(static function () {
        Route::post('/organizations/{organization}/import', [ImportController::class, 'import'])->name('import');
    });
});

/**
 * Fallback routes, to prevent a rendered HTML page in /api/* routes
 * The / route is also included since the fallback is not triggered on the root route
 */
Route::get('/', function (): void {
    throw new NotFoundHttpException('API resource not found');
});
Route::fallback(function (): void {
    throw new NotFoundHttpException('API resource not found');
});