ホーム>Laravel>LaravelでAPIを作成する方法(install:api・apiResource・API Resource、Laravel 13で確認)
Laravel

LaravelでAPIを作成する方法(install:api・apiResource・API Resource、Laravel 13で確認)

いつもご利用ありがとうございます。
この記事にはアフィリエイト広告を含む広告が掲載されており、その広告費によって運営しています。
Amazonのアソシエイトとして、ララテックは適格販売により収入を得ています。

LaravelでJSONを返すAPIを作成する手順です。Laravel 11以降のinstall:apiでroutes/api.phpを作り、apiResource・make:controller --api・API Resourceで投稿のCRUDを作って、curlで201・204・404・422・401・405の実際のレスポンスを確かめました(Laravel 13.43)。

Laravel で、JSON を返す API を作る手順をまとめます。

Laravel 13 で新しく作ったプロジェクトには、routes/api.php がありません!

Laravel 11 のリリースノートによると、多くのアプリでは要らないため、Laravel 11 から api.php は最初から入らなくなったとのことです。

「api.php はどこ?」「/api/〇〇 が 404 になる?」と困るのは、たいていここです。

この記事では、php artisan install:api から始めて、投稿(Post)の一覧・作成・表示・更新・削除の API を作り、curl で実際のレスポンスを確かめました。

確かめた環境

2026年11月に、下の環境で確かめました。

項目バージョン
PHP8.4.28(Docker の php:8.4-cli)
Composer2.11.2
Laravel13.43.0
laravel/sanctumv4.5.0
データベースSQLite

サーバーは php artisan serve で起動し、同じコンテナの中から curl でリクエストを送っています。

新しいプロジェクトには routes/api.php がない

composer create-project laravel/laravel app で作った直後の routes フォルダには、2つしかありませんでした。

$ ls routes
console.php
web.php

bootstrap/app.php のルーティングの登録にも、api はありません。

->withRouting(
    web: __DIR__.'/../routes/web.php',
    commands: __DIR__.'/../routes/console.php',
    health: '/up',
)

この状態で routes フォルダに api.php を手で作っても、読み込まれません。

php artisan install:api で API のルートを有効にする

php artisan install:api を実行します。

php artisan install:api

出力の要点です(途中の composer の出力は省いています)。

./composer.json has been updated
Running composer update laravel/sanctum --with-all-dependencies
  - Installing laravel/sanctum (v4.5.0): Extracting archive

   INFO  Published API routes file.

   INFO  Running migrations.

  2026_11_22_190755_create_personal_access_tokens_table .......... 4.16ms DONE

   INFO  API scaffolding installed. Please add the [Laravel\Sanctum\HasApiTokens] trait to your User model.

このコマンド1つで、次の4つが行われました。

  • laravel/sanctum(API のトークン認証のパッケージ)が composer.json に入る
  • routes/api.php が作られる
  • bootstrap/app.php に api: の行が足される
  • personal_access_tokens テーブルのマイグレーションが作られ、実行される

bootstrap/app.php は、こうなりました。

->withRouting(
    web: __DIR__.'/../routes/web.php',
    api: __DIR__.'/../routes/api.php',
    commands: __DIR__.'/../routes/console.php',
    health: '/up',
)

作られた routes/api.php には、ログイン中のユーザーを返すルートが1つ入っています。

<?php

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;

Route::get('/user', function (Request $request) {
    return $request->user();
})->middleware('auth:sanctum');

php artisan route:list --path=api で見ると、URL の頭に api/ が付いていました。

  GET|HEAD       api/user ................................... routes/api.php:6

                                                            Showing [1] routes

api.php に書いたルートは、自動で /api から始まる URL になります。

試しに /api を付けずに /posts へアクセスすると、404 でした。

最後のメッセージにあるとおり、トークン認証を使うなら User モデルに HasApiTokens を足します。

この記事の CRUD は認証なしで作るので、ここでは足していません。

モデルとマイグレーションを作る

投稿のテーブルを、タイトルと本文だけで作ります。

php artisan make:model Post -m

マイグレーションに2つのカラムを足しました。

Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->text('body');
    $table->timestamps();
});

モデルには、create() でまとめて保存できるように $fillable を書きます。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $fillable = ['title', 'body'];
}
php artisan migrate

マイグレーションのコマンドは、Laravelのmigrateコマンドの使い方にまとめています。

make:controller --api でコントローラーを作る

php artisan make:controller PostController --api --model=Post

--api を付けると、5つのメソッドだけが入ったコントローラーができました。

class PostController extends Controller
{
    /**
     * Display a listing of the resource.
     */
    public function index()
    {
        //
    }

    /**
     * Store a newly created resource in storage.
     */
    public function store(Request $request)
    {
        //
    }

    /**
     * Display the specified resource.
     */
    public function show(Post $post)
    {
        //
    }

    /**
     * Update the specified resource in storage.
     */
    public function update(Request $request, Post $post)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     */
    public function destroy(Post $post)
    {
        //
    }
}

画面でフォームを出すための create と edit は、API では使わないので入っていません。

--model=Post を付けたので、show・update・destroy の引数が Post $post になっています。

apiResource で5つのルートをまとめて登録する

routes/api.php に1行足します。

use App\Http\Controllers\PostController;

Route::apiResource('posts', PostController::class);

php artisan route:list --path=api の結果です。

  GET|HEAD        api/posts ............... posts.index › PostController@index
  POST            api/posts ............... posts.store › PostController@store
  GET|HEAD        api/posts/{post} .......... posts.show › PostController@show
  PUT|PATCH       api/posts/{post} ...... posts.update › PostController@update
  DELETE          api/posts/{post} .... posts.destroy › PostController@destroy
  GET|HEAD        api/user .................................. routes/api.php:7

                                                            Showing [6] routes

Route::resource と違い、posts/create と posts/{post}/edit のルートは作られません。

ルーティングの基本の書き方は、Laravelのルーティングの書き方にあります。

API Resource で返す JSON の形を決める

モデルをそのまま返すと、テーブルのカラムがすべて JSON に出ます。

返す項目を決めるために、API Resource を作ります。

php artisan make:resource PostResource

app/Http/Resources/PostResource.php の toArray() に、返す項目を書きました。

<?php

namespace App\Http\Resources;

use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

class PostResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        return [
            'id' => $this->id,
            'title' => $this->title,
            'body' => $this->body,
            'created_at' => $this->created_at->format('Y-m-d H:i'),
        ];
    }
}

updated_at は返さず、created_at は見やすい形に変えています。

コントローラーの中身を書く

<?php

namespace App\Http\Controllers;

use App\Http\Resources\PostResource;
use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    public function index()
    {
        return PostResource::collection(Post::latest('id')->get());
    }

    public function store(Request $request)
    {
        $validated = $request->validate([
            'title' => ['required', 'string', 'max:100'],
            'body' => ['required', 'string'],
        ]);

        $post = Post::create($validated);

        return (new PostResource($post))
            ->response()
            ->setStatusCode(201);
    }

    public function show(Post $post)
    {
        return new PostResource($post);
    }

    public function update(Request $request, Post $post)
    {
        $validated = $request->validate([
            'title' => ['sometimes', 'string', 'max:100'],
            'body' => ['sometimes', 'string'],
        ]);

        $post->update($validated);

        return new PostResource($post);
    }

    public function destroy(Post $post)
    {
        $post->delete();

        return response()->noContent();
    }
}

作成は 201 Created、削除は中身のない 204 No Content を返すようにしています。

update は sometimes にして、送った項目だけを変えられるようにしました。

バリデーションのルールは、Laravelのバリデーションルールの書き方にまとめています。

curl で API を動かした結果

ここからは、php artisan serve で起動したサーバーに curl でリクエストを送った結果です。

-H 'Accept: application/json' は、JSON で返してほしいことを伝えるヘッダーです。

一覧(GET /api/posts)

データがないときは、空の配列が data に入って返りました。

$ curl -s -i http://localhost:8000/api/posts -H 'Accept: application/json'
HTTP/1.1 200 OK
Content-Type: application/json
{"data":[]}

API Resource を使うと、結果は data で包まれます。

作成(POST /api/posts)

curl -s -i -X POST http://localhost:8000/api/posts \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"title":"はじめてのAPI","body":"Laravel 13で作りました"}'
HTTP/1.1 201 Created
{"data":{"id":1,"title":"はじめてのAPI","body":"Laravel 13で作りました","created_at":"2026-11-22 19:08"}}

日本語が は のような形で返ってきて、文字化けしたように見えます。

これは JSON の書き方の1つで、受け取った側で JSON として読めば元の日本語に戻ります(下の更新のあとで確かめています)。

1件の表示・更新・削除

もう1件作ってから、一覧・表示・更新・削除を順に試しました。

$ curl -s http://localhost:8000/api/posts -H 'Accept: application/json'
{"data":[{"id":2,"title":"2件目","body":"本文です","created_at":"2026-11-22 19:08"},{"id":1,"title":"はじめてのAPI","body":"Laravel 13で作りました","created_at":"2026-11-22 19:08"}]}

$ curl -s http://localhost:8000/api/posts/1 -H 'Accept: application/json'
{"data":{"id":1,"title":"はじめてのAPI","body":"Laravel 13で作りました","created_at":"2026-11-22 19:08"}}

PATCH でタイトルだけを送ると、本文はそのままでタイトルだけ変わりました。

$ curl -s -X PATCH http://localhost:8000/api/posts/1 \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -d '{"title":"タイトルを変えました"}'
{"data":{"id":1,"title":"タイトルを変えました","body":"Laravel 13で作りました","created_at":"2026-11-22 19:08"}}

この結果を PHP の json_decode() で読んでみると、ちゃんと日本語に戻りました。

$ curl -s http://localhost:8000/api/posts/1 -H 'Accept: application/json' \
  | php -r 'print_r(json_decode(stream_get_contents(STDIN), true));'
Array
(
    [data] => Array
        (
            [id] => 1
            [title] => タイトルを変えました
            [body] => Laravel 13で作りました
            [created_at] => 2026-11-22 19:08
        )

)

削除は 204 で、中身は空でした。

$ curl -s -i -X DELETE http://localhost:8000/api/posts/2 -H 'Accept: application/json'
HTTP/1.1 204 No Content

エラーのときに返る JSON

API で困るのは、うまくいかなかったときの返事です。

わざとエラーを起こして、何が返るかを見ました。

バリデーションエラーは 422

タイトルを空にして送ると、422 とエラーの中身が返りました。

$ curl -s -i -X POST http://localhost:8000/api/posts \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -d '{"title":""}'
HTTP/1.1 422 Unprocessable Content
{"message":"The title field is required. (and 1 more error)","errors":{"title":["The title field is required."],"body":["The body field is required."]}}

errors に項目ごとのメッセージが入るので、フロント側で入力欄の下に出せます。

エラー文を日本語にするには、言語ファイルの設定が別に要ります。

Laravel 13 では、Accept: application/json を付けなくても、同じ 422 の JSON が返りました。

新しいプロジェクトの bootstrap/app.php に、/api/ から始まる URL のエラーを JSON で返す設定が最初から入っていたためです。

->withExceptions(function (Exceptions $exceptions): void {
    $exceptions->shouldRenderJsonWhen(
        fn (Request $request) => $request->is('api/*') || $request->expectsJson(),
    );

ない ID は 404

/api/posts/999 のように、ない ID を指定すると 404 でした。

APP_DEBUG=true(開発中の設定)では、例外の種類やファイルの場所まで JSON に入ります。

HTTP/1.1 404 Not Found
{
    "message": "No query results for model [App\\Models\\Post] 999",
    "exception": "Symfony\\Component\\HttpKernel\\Exception\\NotFoundHttpException",
    "file": "/work/app/vendor/laravel/framework/src/Illuminate/Foundation/Exceptions/Handler.php",
    "line": 773,
    "trace": [

APP_DEBUG=false(本番の設定)にすると、message だけになりました。

{
    "message": "No query results for model [App\\Models\\Post] 999"
}

このエラー文については、Laravelでモデルがnot foundになるときの解決方法でも書いています。

対応していないメソッドは 405

一覧の URL に PUT を送ると、405 でした。

HTTP/1.0 405 Method Not Allowed
"message": "The PUT method is not supported for route api/posts. Supported methods: GET, HEAD, POST.",

PUT や DELETE は、/api/posts/1 のように ID の付いた URL に送ります。

api.php のルートは CSRF トークンなしで POST できる

web.php のルートに POST するときは、CSRF トークンがないと 419 エラーになります。

api.php のルートは、トークンなしのフォーム形式で POST しても 201 で保存されました。

$ curl -s -i -X POST http://localhost:8000/api/posts -d 'title=form&body=formbody'
HTTP/1.1 201 Created
{"data":{"id":3,"title":"form","body":"formbody","created_at":"2026-11-22 19:08"}}

逆に言うと、このままでは誰でも投稿や削除ができる API です。

公開するときは、下の認証を付けてください。

web.php 側の 419 エラーについては、Laravelの419エラーの原因と解決方法にあります。

最初から入っている /api/user は、ヘッダーで結果が変わる

install:api で作られた /api/user には、auth:sanctum が付いています。

トークンなしで Accept: application/json を付けて送ると、401 でした。

$ curl -s -i http://localhost:8000/api/user -H 'Accept: application/json'
HTTP/1.1 401 Unauthorized
{"message":"Unauthenticated."}

Accept を付けずに送ると、500 エラーになりました(><)

$ curl -s http://localhost:8000/api/user
{
    "message": "Route [login] not defined.",

ログインしていない人をログイン画面へ移そうとして、login という名前のルートが見つからなかったためです。

APP_DEBUG=false では {"message": "Server Error"} としか返らないので、原因が分かりにくくなります。

API を呼ぶ側では、Accept: application/json を付けておくのが安全です。

このエラーは、Laravelでログインしたユーザーだけが使えるルーティングの書き方でも詳しく確かめています。

参考:トークン認証と CORS

Laravel の公式ドキュメントによると、install:api で入る Sanctum は、モバイルアプリなどに API トークンを発行する使い方と、同じドメインの SPA から Cookie で認証する使い方の両方に対応しているとのことです。

トークンを使う場合は、User モデルに HasApiTokens を足し、$user->createToken('名前')->plainTextToken で発行したトークンを Authorization: Bearer ヘッダーで送る、と説明されています。

別のドメインのフロントエンドから呼ぶときは、CORS の設定も必要になるようです。

CORS の設定は、Laravel の Cors で特定のオリジンを許可する方法に書いています。

まとめ

Laravel 13 で API を作る流れは、次のとおりでした。

  1. php artisan install:api で routes/api.php を作る(Sanctum も入る)
  2. make:model -m でモデルとテーブルを作る
  3. make:controller --api --model=〇〇 で5つのメソッドのコントローラーを作る
  4. Route::apiResource() で5つのルートを登録する
  5. make:resource で返す JSON の形を決める

「api.php がない」で止まっていた人は、まず install:api を実行してみてください!

エラーの JSON まで見ておくと、フロント側を作るときに迷いにくくなります(^^)

フィードバックのお願い
この記事のフィードバックがありましたらYoutubeの適当な動画にコメントしていただいたり、お問い合わせからご連絡ください。