LaravelでAPIを作成する方法(install:api・apiResource・API Resource、Laravel 13で確認)
目次
- 確かめた環境
- 新しいプロジェクトには routes/api.php がない
- php artisan install:api で API のルートを有効にする
- モデルとマイグレーションを作る
- make:controller --api でコントローラーを作る
- apiResource で5つのルートをまとめて登録する
- API Resource で返す JSON の形を決める
- コントローラーの中身を書く
- curl で API を動かした結果
- エラーのときに返る JSON
- api.php のルートは CSRF トークンなしで POST できる
- 最初から入っている /api/user は、ヘッダーで結果が変わる
- 参考:トークン認証と CORS
- まとめ
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月に、下の環境で確かめました。
| 項目 | バージョン |
|---|---|
| PHP | 8.4.28(Docker の php:8.4-cli) |
| Composer | 2.11.2 |
| Laravel | 13.43.0 |
| laravel/sanctum | v4.5.0 |
| データベース | SQLite |
サーバーは php artisan serve で起動し、同じコンテナの中から curl でリクエストを送っています。
新しいプロジェクトには routes/api.php がない
composer create-project laravel/laravel app で作った直後の routes フォルダには、2つしかありませんでした。
$ ls routes
console.php
web.phpbootstrap/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] routesapi.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] routesRoute::resource と違い、posts/create と posts/{post}/edit のルートは作られません。
ルーティングの基本の書き方は、Laravelのルーティングの書き方にあります。
API Resource で返す JSON の形を決める
モデルをそのまま返すと、テーブルのカラムがすべて JSON に出ます。
返す項目を決めるために、API Resource を作ります。
php artisan make:resource PostResourceapp/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 ヘッダーで送る、と説明されています。
- Laravel Sanctum - Laravel 13.x
- Routing(API Routes) - Laravel 13.x
- Eloquent: API Resources - Laravel 13.x
別のドメインのフロントエンドから呼ぶときは、CORS の設定も必要になるようです。
CORS の設定は、Laravel の Cors で特定のオリジンを許可する方法に書いています。
まとめ
Laravel 13 で API を作る流れは、次のとおりでした。
php artisan install:apiで routes/api.php を作る(Sanctum も入る)make:model -mでモデルとテーブルを作るmake:controller --api --model=〇〇で5つのメソッドのコントローラーを作るRoute::apiResource()で5つのルートを登録するmake:resourceで返す JSON の形を決める
「api.php がない」で止まっていた人は、まず install:api を実行してみてください!
エラーの JSON まで見ておくと、フロント側を作るときに迷いにくくなります(^^)




