Building Scalable RESTful APIs with Laravel 11: Complete Architecture

Building robust, high-throughput RESTful JSON APIs is one of Laravel's greatest strengths. Whether you are powering native iOS/Android mobile applications, frontend Single Page Applications (Next.js, React, Vue), or third-party webhooks, Laravel provides a dedicated stateless routing file (routes/api.php), API resource controllers, and standardized JSON exception handling.

1. Generating an API Resource Controller

Unlike traditional web controllers that return HTML views (and thus need create and edit form actions), API controllers only require 5 actions: index, store, show, update, and destroy:

php artisan make:controller Api/V1/ArticleController --api --model=Article

Notice the --api flag! It automatically omits the unnecessary HTML form actions. Register the API route in routes/api.php with versioning:

use App\Http\Controllers\Api\V1\ArticleController;

Route::prefix('v1')->group(function () {
    Route::apiResource('articles', ArticleController::class);
});

2. HTTP Status Code Conventions

A professional REST API must never return a generic 200 OK for errors. Adhere strictly to industry standard HTTP response codes:

3. Structuring an API Controller Implementation

Here is a complete, production-grade API controller action:

namespace App\Http\Controllers\Api\V1;

use App\Http\Controllers\Controller;
use App\Models\Article;
use App\Http\Requests\StoreArticleRequest;
use App\Http\Resources\ArticleResource;
use Illuminate\Http\JsonResponse;

class ArticleController extends Controller
{
    public function store(StoreArticleRequest $request): JsonResponse
    {
        $article = $request->user()->articles()->create($request->validated());

        return (new ArticleResource($article))
            ->response()
            ->setStatusCode(201);
    }

    public function destroy(Article $article): JsonResponse
    {
        $this->authorize('delete', $article);
        $article->delete();

        return response()->json(null, 204);
    }
}