<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>API連携 &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/tag/api-integration/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Wed, 18 Nov 2026 21:49:32 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://cfxlog.com/wp-content/uploads/2026/07/cfxlog-favicon-150x150.png</url>
	<title>API連携 &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>【Django REST framework】REST APIを開発する方法</title>
		<link>https://cfxlog.com/drf/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 07 Aug 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5226</guid>

					<description><![CDATA[このような疑問にお答えします。 Django では “Django REST framework”（以下、「DRF」とします） というフレームワークを使うことで、REST API を開発することができます。 最初に Dj [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django を使って REST API を開発したい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">Django では “Django REST framework”（以下、「DRF」とします） というフレームワークを使うことで、REST API を開発することができます。</p>



<p class="wp-block-paragraph">最初に Django をインストールした上で、さらに DRF をインストールする流れです。</p>



<p class="wp-block-paragraph">本記事では以下の内容をお伝えします。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>API 開発に DRF を採用するメリット</li>

<li>DRF を使った API 開発の流れ</li>

<li>DRF をさらに使いこなす実装例</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事さえご覧いただければ DRF の全体像を掴んでいただけるよう、内容を網羅して解説していきます。</p>



<p class="wp-block-paragraph">ただし分量が膨大になってしまう関係で、細かいトピックは別記事を用意しています。関連記事も併せてご覧いただくことで、より DRF を使いこなすことができるようになるはずです。</p>



<p class="is-style-icon_info wp-block-paragraph">ここでは「REST API がどのようなものか？」といったものは解説しません。</p>



<h2 class="wp-block-heading">DRFの主な機能</h2>



<p class="wp-block-paragraph">まずは DRF がどのようなフレームワークかを解説します。</p>



<p class="wp-block-paragraph">API 開発のためのフレームワークには Python でいえば Flask, FastAPI などが、他の言語であれば NestJS, Spring Boot, Ruby on Rails などがあります。</p>



<p class="wp-block-paragraph">その中でも DRF を利用するメリットなどを理解して、技術選定の一助としてみてください。</p>



<p class="wp-block-paragraph">ここでは簡単に DRF で実装できる機能と、簡単な説明をしていきます。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>シリアライゼーション</strong></li>

<li><strong>ビューセットとルーター</strong></li>

<li><strong>認証と権限付与</strong></li>

<li><strong>ページネーションとフィルタリング</strong></li>

<li><strong>ブラウザブルAPI</strong></li>

<li><strong>バージョニング</strong></li>

<li><strong>セキュリティ</strong></li>
</ul>
</div></div>



<p class="wp-block-paragraph">それぞれ、掘り下げて解説します。</p>



<h3 class="wp-block-heading">シリアライゼーション</h3>



<p class="wp-block-paragraph">Django 内部で処理された Python オブジェクトを、JSON や XML などのフロントエンドで解釈がしやすい形式に変換することができます。</p>



<p class="wp-block-paragraph">この変換機能を「シリアライズ」と呼び、これが DRF の代表的な機能の一つになります。</p>



<h3 class="wp-block-heading">ビューセットとルーター</h3>



<p class="wp-block-paragraph">API のアクセス先となるエンドポイントを決定することができます。</p>



<p class="wp-block-paragraph">大元のフレームワークは Django を利用しているので、ビューとルーターはそれぞれ “views.py” と “urls.py” で制御することになります。</p>



<h3 class="wp-block-heading">認証と権限付与</h3>



<p class="wp-block-paragraph">Basic 認証、セッション認証、トークン認証を標準でサポートしています。</p>



<p class="wp-block-paragraph">また、”REST framework api key” などのサードパーティライブラリを使うことで、API Key 認証機能なども実装することができます。</p>



<h3 class="wp-block-heading">ページネーションとフィルタリング</h3>



<p class="wp-block-paragraph">大量のデータを小分けできる「ページネーション」が実装できます。</p>



<p class="wp-block-paragraph">これにより、レスポンス速度が向上したり、ユーザーがデータを簡単に見つけやすくできます。</p>



<p class="wp-block-paragraph">DRF では以下のようなページネーション種類を提供しています。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>LimitOffsetPagination</li>

<li>PageNumberPagination</li>

<li>CursorPagination</li>
</ul>
</div></div>



<p class="wp-block-paragraph">settings.py に記述すれば全体にページネーションを反映させることができますし、ビューごとにページネーションを個別設定することも可能です。</p>



<p class="wp-block-paragraph">また、特定のキーワードで検索したりといった「フィルタリング」も簡単に実装できます。</p>



<p class="wp-block-paragraph">フィルタリングバックエンドとしては、以下のようなものがあります。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>DjangoFilterBackend</li>

<li>SearchFilter</li>

<li>OrderingFilter</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これらの詳細は、別記事で解説する予定です。</p>



<h3 class="wp-block-heading">ブラウザブルAPI</h3>



<p class="wp-block-paragraph">ブラウザから直接 API を閲覧できる機能です。</p>



<p class="wp-block-paragraph">これにより API の挙動を簡単に確認できるので、フロントエンド開発者や API 利用者にとっても理解しやすくなります。</p>



<p class="is-style-icon_info wp-block-paragraph">ブラウザブルAPIはデフォルト機能ですが、うまく動作しない場合には settings.py の DEFAULT_RENDERER_CLASSES に BrowsableAPIRenderer あるか確認してください。</p>



<h3 class="wp-block-heading">バージョニング</h3>



<p class="wp-block-paragraph">urls.py でバージョンごとにエンドポイントを切り替えることで、バージョンごとの管理が簡単に行えます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path, include

urlpatterns = [
    path('api/v1/', include('app_v1.urls')),  # v1のAPI
    path('api/v2/', include('app_v2.urls')),  # v2のAPI
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path, include</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'api/v1/'</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">'app_v1.urls'</span><span style="color:#D4D4D4">)),  </span><span style="color:#6A9955"># v1のAPI</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'api/v2/'</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">'app_v2.urls'</span><span style="color:#D4D4D4">)),  </span><span style="color:#6A9955"># v2のAPI</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">バージョニング方法は、後日別記事で詳しく紹介する予定です。</p>



<h3 class="wp-block-heading">セキュリティ</h3>



<p class="wp-block-paragraph">CSRF 保護や CORS ヘッダーの管理など、セキュリティ対策が組み込まれています。</p>



<h2 class="wp-block-heading">DRFを採用するメリット</h2>



<p class="wp-block-paragraph">DRF を採用することで、以下のメリットが得られます。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django と統合している</li>

<li>高度なシリアライゼーションが可能</li>

<li>細かく認証設定ができる</li>
</ul>
</div></div>



<h3 class="wp-block-heading">Django と統合している</h3>



<p class="wp-block-paragraph">すでに Python や Django を使い慣れている方には、学習コストを抑えて導入ができます。</p>



<p class="wp-block-paragraph">また、Djangoのモデル、ユーザー認証、管理画面などがそのまま使えることも大きなメリットの一つです。</p>



<h3 class="wp-block-heading">高度なシリアライゼーションが可能</h3>



<p class="wp-block-paragraph">Django モデルから API に簡単に変換できる仕組みが備わっています。</p>



<p class="wp-block-paragraph">他のフレームワークでは、モデルの変換・複雑なデータモデルのサポート・フィールドレベルのカスタマイズなどが煩雑になりがちですが、Django を使うことでシンプルに記述できるようになります。</p>



<h3 class="wp-block-heading">細かく認証設定ができる</h3>



<p class="wp-block-paragraph">DRF では標準で「基本認証」「トークン認証」「OAuth」などをサポートしています。</p>



<p class="wp-block-paragraph">さらに、Django 標準で搭載されている「セッション管理」「CSRF」などのセキュリティ機能とも連動。</p>



<p class="wp-block-paragraph">ビューごとに異なる認証方法を採用したり、ユーザーやグループごとに認証方式を変えることもでき、柔軟性の高さが魅力です。</p>



<h2 class="wp-block-heading">DRFを使ったAPI開発の流れ</h2>



<p class="wp-block-paragraph">ここからは実際に DRF を使った API 開発の流れをお伝えします。</p>



<p class="wp-block-paragraph">基本的な流れとして、以下の流れで説明します。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>プロジェクトのセットアップ</li>

<li>モデルの定義</li>

<li>シリアライザの作成</li>

<li>ビューの作成</li>

<li>ルーティングの設定</li>

<li>認証と権限の設定</li>

<li>テスト</li>
</ul>
</div></div>



<h3 class="wp-block-heading">① プロジェクトのセットアップ</h3>



<p class="wp-block-paragraph">Django を開発環境にインストールします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install django</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> django</span></span></code></pre></div>



<p class="wp-block-paragraph">続いて Django のプロジェクトをセットアップを行いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>django-admin startproject projectname</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">django-admin</span><span style="color:#CE9178"> startproject</span><span style="color:#CE9178"> projectname</span></span></code></pre></div>



<p class="wp-block-paragraph">アプリケーションの作成を行いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>cd projectname
python manage.py startapp api</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">cd</span><span style="color:#CE9178"> projectname</span></span>
<span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> startapp</span><span style="color:#CE9178"> api</span></span></code></pre></div>



<p class="wp-block-paragraph">さらに、DRF を使用するため以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install djangorestframework</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> djangorestframework</span></span></code></pre></div>



<p class="wp-block-paragraph">settings.py に以下を追記して、DRF を使える状態にしましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = [
    ...
    'rest_framework',
    'api',
    ...
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">INSTALLED_APPS = [</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#CE9178">    'rest_framework'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    'api'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">これでセットアップは完了です。</p>



<h3 class="wp-block-heading">② モデルの定義</h3>



<p class="wp-block-paragraph">一般的な Django プロジェクトと同様、models.py に以下のような形で記載します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

    def __str__(self):
        return self.title</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.db </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> models</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> Post</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">models</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">Model</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    title = models.CharField(</span><span style="color:#9CDCFE">max_length</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    content = models.TextField()</span></span>
<span class="line"><span style="color:#D4D4D4">    created_at = models.DateTimeField(</span><span style="color:#9CDCFE">auto_now_add</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    updated_at = models.DateTimeField(</span><span style="color:#9CDCFE">auto_now</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> __str__</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#569CD6"> self</span><span style="color:#D4D4D4">.title</span></span></code></pre></div>



<p class="wp-block-paragraph">これをデータベースに適用するため、以下のコマンドを実行してマイグレーションを行いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>python manage.py makemigrations
python manage.py migrate</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> makemigrations</span></span>
<span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> migrate</span></span></code></pre></div>



<h3 class="wp-block-heading">③ シリアライザの作成</h3>



<p class="wp-block-paragraph">続いてレスポンスとして JSON などを返せるよう、アプリディレクトリ内に serializers.py を作成して以下のように記述しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework import serializers
from .models import Post

class PostSerializer(serializers.ModelSerializer):
    class Meta:
        model = Post
        fields = ['id', 'title', 'content', 'created_at', 'updated_at']</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> serializers</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Post</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostSerializer</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">serializers</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">ModelSerializer</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    class</span><span style="color:#4EC9B0"> Meta</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">        model = Post</span></span>
<span class="line"><span style="color:#D4D4D4">        fields = [</span><span style="color:#CE9178">'id'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'title'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'content'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'created_at'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'updated_at'</span><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h3 class="wp-block-heading">④ ビューの作成</h3>



<p class="wp-block-paragraph">先ほど作成したシリアライザを “views.py” 内で指定して、JSON 形式でレスポンスを行うように指定します。一覧表示用の<code>PostListView</code>と、詳細表示用の<code>PostDetailView</code>を両方作成します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework.generics import ListAPIView, RetrieveAPIView
from .models import Post
from .serializers import PostSerializer

class PostListView(ListAPIView):
    queryset = Post.objects.all()
    serializer_class = PostSerializer

class PostDetailView(RetrieveAPIView):
    queryset = Post.objects.all()
    serializer_class = PostSerializer</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.generics </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> ListAPIView, RetrieveAPIView</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Post</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .serializers </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> PostSerializer</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostListView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">ListAPIView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    queryset = Post.objects.all()</span></span>
<span class="line"><span style="color:#D4D4D4">    serializer_class = PostSerializer</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostDetailView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">RetrieveAPIView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    queryset = Post.objects.all()</span></span>
<span class="line"><span style="color:#D4D4D4">    serializer_class = PostSerializer</span></span></code></pre></div>



<h3 class="wp-block-heading">⑤ ルーティングの設定</h3>



<p class="wp-block-paragraph">さらに、エンドポイントの定義を行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path
from .views import PostDetailView, PostListView

urlpatterns = [
    path('posts/', PostListView.as_view(), name='post-list'),
    path('posts/&lt;int:pk&gt;/', PostDetailView.as_view(), name='post-detail'),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> PostDetailView, PostListView</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'posts/'</span><span style="color:#D4D4D4">, PostListView.as_view(), </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'post-list'</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'posts/&lt;int:pk>/'</span><span style="color:#D4D4D4">, PostDetailView.as_view(), </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'post-detail'</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h3 class="wp-block-heading">⑥ 認証と権限の設定</h3>



<p class="wp-block-paragraph">settings.py に以下のような追記を行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = [
    ...
    'rest_framework',
    'rest_framework.authtoken',
    ...
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">INSTALLED_APPS = [</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#CE9178">    'rest_framework'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    'rest_framework.authtoken'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">さらに、urls.py にトークン認証のエンドポイントを追加。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path
from rest_framework.authtoken.views import obtain_auth_token

urlpatterns = [
    ...
    path('api-token-auth/', obtain_auth_token, name='api_token_auth'),
    ...
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.authtoken.views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> obtain_auth_token</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'api-token-auth/'</span><span style="color:#D4D4D4">, obtain_auth_token, </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'api_token_auth'</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">そして認証の詳細を定義するため、以下のコードを追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework.permissions import IsAuthenticated
from rest_framework.views import APIView
from rest_framework.response import Response

class ExampleView(APIView):
    permission_classes = [IsAuthenticated]

    def get(self, request, format=None):
        content = {
            'message': 'Hello, World!'
        }
        return Response(content)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.permissions </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> IsAuthenticated</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> APIView</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.response </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Response</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ExampleView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">APIView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    permission_classes = [IsAuthenticated]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> get</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">format</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">None</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        content = {</span></span>
<span class="line"><span style="color:#CE9178">            'message'</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">'Hello, World!'</span></span>
<span class="line"><span style="color:#D4D4D4">        }</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> Response(content)</span></span></code></pre></div>



<p class="wp-block-paragraph">IsAuthenticated を指定することで、トークン認証を有効化することができます。</p>



<h3 class="wp-block-heading">⑦ テスト</h3>



<p class="wp-block-paragraph">最後に test.py などに以下のようなテストコードを記載します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework.test import APITestCase
from rest_framework import status
from django.urls import reverse
from .models import Post

class PostAPITest(APITestCase):
    def setUp(self):
        # テスト用のデータを準備
        Post.objects.create(title='Test Post 1', content='Test Content 1')
        Post.objects.create(title='Test Post 2', content='Test Content 2')

    def test_view_posts(self):
        url = reverse('post-list')
        response = self.client.get(url)
        self.assertEqual(response.status_code, status.HTTP_200_OK)
        self.assertEqual(len(response.data), 2)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.test </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> APITestCase</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> status</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> reverse</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Post</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostAPITest</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">APITestCase</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> setUp</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#6A9955">        # テスト用のデータを準備</span></span>
<span class="line"><span style="color:#D4D4D4">        Post.objects.create(</span><span style="color:#9CDCFE">title</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Post 1'</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">content</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Content 1'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">        Post.objects.create(</span><span style="color:#9CDCFE">title</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Post 2'</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">content</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Content 2'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> test_view_posts</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        url = reverse(</span><span style="color:#CE9178">'post-list'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">        response = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.client.get(url)</span></span>
<span class="line"><span style="color:#569CD6">        self</span><span style="color:#D4D4D4">.assertEqual(response.status_code, status.HTTP_200_OK)</span></span>
<span class="line"><span style="color:#569CD6">        self</span><span style="color:#D4D4D4">.assertEqual(</span><span style="color:#DCDCAA">len</span><span style="color:#D4D4D4">(response.data), </span><span style="color:#B5CEA8">2</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">これで基本的な API 作成は完了です。</p>



<h2 class="wp-block-heading">DRFをさらに使いこなす実装例</h2>



<p class="wp-block-paragraph">次のような DRF の標準機能を拡張する方法をお伝えします。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>CORS ヘッダーを付与する</li>

<li>API Key 認証を追加する</li>

<li>画像アップロード機能を実装する</li>
</ul>
</div></div>



<h3 class="wp-block-heading">CORSヘッダーを付与する</h3>



<p class="wp-block-paragraph">フロントエンドとして React などの JavaScript フレームワークを使う場合には、 CORS 対策を行うことがあります。</p>



<p class="wp-block-paragraph">以下の記事では、”django-cors-headers” を利用した実装方法をご紹介しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-rest-cors/">Django REST framework で CORS 対策をする方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で CORS エラーが出ている… このような場合の対策をお伝えします。 Django REST framework（以下「DRF」とします）では、外部ライブラリを使うこ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">API Key認証を追加する</h3>



<p class="wp-block-paragraph">サードパーティライブラリ “restframework-api-key” を使えば、 API Key 認証機能を追加することができます。</p>



<p class="wp-block-paragraph">詳しい実装方法は、後日別記事で解説する予定です。</p>



<h3 class="wp-block-heading">画像アップロード機能を実装する</h3>



<p class="wp-block-paragraph">API に画像アップロード機能を実装するには、少し工夫が必要です。</p>



<p class="wp-block-paragraph">以下の記事で詳細を解説しましたので、ご覧ください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-drf-upload-image/">【Django REST framework】画像ファイルアップロード機能の実装方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で画像アップロード機能を実装したい！ Django REST framework（以下、「DRF」とします）で画像アップロード機能を実装するには、いくつかのステ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Python で API 開発をする場合、真っ先に候補に上がるのが DRF になると思います。</p>



<p class="wp-block-paragraph">本記事では DRF の全体像をざっと見渡してきました。</p>



<p class="wp-block-paragraph">本ブログでは Python を中心としてプログラミングに関する情報を発信しています。</p>



<p class="wp-block-paragraph">ぜひ、他の記事にも目を通してみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django完全入門ガイド｜MTVの基本から認証・API・デプロイまで全ステップ解説</title>
		<link>https://cfxlog.com/python-django-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 31 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/python-django-guide/</guid>

					<description><![CDATA[このような疑問にお答えします。 Djangoは、Pythonで書けるWebフレームワークです。モデル・認証・管理画面といった、Webアプリに必要な機能が最初から揃っています。 このガイドでは、Djangoの基本的な考え方 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Djangoって何から始めればいいの？</li>

<li>MTVの構造がよくわからない</li>

<li>認証やAPI連携、本番デプロイまで一通り学びたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">Djangoは、Pythonで書けるWebフレームワークです。モデル・認証・管理画面といった、Webアプリに必要な機能が最初から揃っています。</p>



<p class="wp-block-paragraph">このガイドでは、<strong>Djangoの基本的な考え方から、実際に画面を表示するところまで</strong>をステップ順に解説します。<br>記事後半には、モデル・認証・API・デプロイなど、テーマ別の詳細ガイドへのロードマップも用意しました。「どこから学べばいいかわからない」という悩みは、これで解消できるはずです。</p>



<h2 class="wp-block-heading">Djangoとは何か</h2>



<p class="wp-block-paragraph">Djangoは、Pythonで書かれたWebフレームワークです。データベースとのやり取り、URL設計、管理画面、認証など、Webアプリでほぼ必ず必要になる機能が標準で用意されています。</p>



<p class="wp-block-paragraph">Djangoの設計は<strong>MTV（Model・Template・View）</strong>という3つの役割に分かれています。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>要素</th><th>役割</th></tr></thead><tbody><tr><td>Model</td><td>データベースの構造・データのやり取り</td></tr><tr><td>Template</td><td>画面に表示するHTML</td></tr><tr><td>View</td><td>リクエストを受けてModelとTemplateをつなぐ処理</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">一般的なMVCと呼び方が違うだけで、考え方はほぼ同じです。「データ」「画面」「つなぐ処理」の3つに分かれている、とだけ覚えておけば十分です。</p>



<h3 class="wp-block-heading">なぜDjangoを選ぶのか</h3>



<p class="wp-block-paragraph">正直なところ、バックエンドの言語やフレームワークは、使い慣れたものを自由に選べばいいと思っています。他に慣れている言語があるなら、そちらで作っても何の問題もありません。</p>



<p class="wp-block-paragraph">僕がDjangoを選んでいるのは、単純にPythonに慣れているからです。認証・管理画面・ORMといった機能が最初から揃っているので、Pythonが書けるなら学習コストは低めです。</p>



<h2 class="wp-block-heading">Djangoを始める前の準備</h2>



<p class="wp-block-paragraph">環境構築の細かい手順は、後半のロードマップ内の記事にまとめています。ここでは全体の流れだけ押さえておきます。</p>



<p class="wp-block-paragraph">大まかな流れは、<strong>仮想環境の作成 → Djangoのインストール → プロジェクトの作成 → アプリの作成</strong>の4ステップです。プロジェクトが「サイト全体の入れ物」、アプリが「機能ごとの部品」という関係になっています。</p>



<h2 class="wp-block-heading">Djangoの基本的な考え方</h2>



<p class="wp-block-paragraph">僕自身、Djangoが最初に触ったWebフレームワークだったので、正直はじめは全部につまずきました。</p>



<p class="wp-block-paragraph">中でも馴染めなかったのが、<strong>フレームワーク特有の「お作法」を、途中の理屈を全部理解する前に「そういうものだ」と割り切って受け入れる</strong>ことでした。「なぜこのファイルにこう書くのか」を最初から全部理解しようとすると、手が止まってしまいます。</p>



<p class="wp-block-paragraph">Djangoには、settings.pyで設定を管理する、urls.pyでルーティングを書く、views.pyで処理を書く、といった「決まった置き場所」があります。まずはこの型をなぞって動かしてみて、理屈は後から追いつけばいいというくらいの気持ちで進めるのがおすすめです。</p>



<h2 class="wp-block-heading">はじめての画面を表示してみよう</h2>



<p class="wp-block-paragraph">理屈の説明が続いたので、実際に画面を表示するところまでやってみましょう。urls.pyとviews.pyだけで完結する、最小構成の例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># views.py
from django.http import HttpResponse

def hello(request):
    return HttpResponse("Hello, Django!")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># views.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.http </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> HttpResponse</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> hello</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#C586C0">    return</span><span style="color:#D4D4D4"> HttpResponse(</span><span style="color:#CE9178">"Hello, Django!"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># urls.py
from django.urls import path
from . import views

urlpatterns = [
    path("hello/", views.hello),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># urls.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> . </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> views</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"hello/"</span><span style="color:#D4D4D4">, views.hello),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">「/hello/」にアクセスすると、views.pyのhello関数が呼ばれ、urls.pyがそのURLとの対応を管理する。これがDjangoのリクエスト処理の基本形です。実際のアプリではここにModelやTemplateが加わりますが、骨格はこの2ファイルの関係と変わりません。</p>



<h2 class="wp-block-heading">Django学習ロードマップ</h2>



<p class="wp-block-paragraph">基本が掴めたら、次のステップに進みましょう。以下はCFXLOGのDjango関連記事一覧です。テーマ別にまとめているので、気になるテーマから読み進めてください。</p>



<h3 class="wp-block-heading">Step 1：プロジェクトを立ち上げる</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-project-setup-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-project-setup/">【Django】プロジェクトとアプリの設定方法まとめ</a>
						<span class="p-blogCard__excerpt">Djangoの開発を始めるための準備が知りたい！ 普通にPythonでコーディングするのと違って、Djangoの開発では細々した準備が必要です。 内容をざっと列挙すると以下の通&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-settings-best-practices-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-settings-best-practices/">【Django】settings.pyの僕的ベストプラクティスをご紹介</a>
						<span class="p-blogCard__excerpt">settings.pyのベストプラクティスが知りたい！ 本記事では、僕が個人開発で使っているsettings.pyの内容を公開します。 ぜひ参考にしてみてください。 【Django】settin&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Step 2：モデル・データベースを扱う</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-models-guide/">【Django】モデル・マイグレーション完全ガイド｜フィールド設計からリレーションまで徹底解説</a>
						<span class="p-blogCard__excerpt">Djangoに触り始めた頃、モデルの前にまずデータベースそのものをよく知りませんでした。 モデルのクラス定義自体はPythonなので読めます。ただ、フィールドの引数に何を&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-queryset-cheatsheet-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-queryset-cheatsheet/">【Django】QuerySetの使い方まとめ【ORM操作を一気に理解するチートシート】</a>
						<span class="p-blogCard__excerpt">Django の QuerySet 操作を逆引きで調べたい！ このような方に向けて、Django でよく使う操作を中心にまとめました。 各メソッドの説明はジャンルに分けてありますので&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-get-age-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-get-age/">【Django】最新の年齢を取得し続ける2つの方法</a>
						<span class="p-blogCard__excerpt">ユーザーの年齢は常に最新の値が欲しい！ このような方に向けて書きました。 本記事では最新の年齢を取得し続けるための方法を解説します。 年齢をデータベースで年齢を&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-docker-migrations-fix/">【Django × Docker】開発中のマイグレーション不整合問題はどう対処する？DBを消す場合・消さない場合の&#8230;</a>
						<span class="p-blogCard__excerpt">Django 開発でよく発生するのが、マイグレーションとデータベースの不整合。特に Docker でデプロイしながら開発していると、 ローカルでマイグレーションをやり直した &#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Step 3：ビュー・URLルーティングを書く</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-views-guide/">【Django】ビュー・URLルーティング完全ガイド｜FBV・CBV・URLconfを徹底解説</a>
						<span class="p-blogCard__excerpt">Djangoのビューには、関数で書くFBV（Function Based View）と、クラスで書くCBV（Class Based View）の2種類があります。 最初にCBVを見たとき、正直よくわかりません&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Step 4：認証を実装する</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-custom-user-model/">【Django】カスタムユーザーモデルの作り方【認証】</a>
						<span class="p-blogCard__excerpt">カスタムユーザーモデルの概念がどうしても理解できない 標準のUserモデルからカスタムユーザーモデルへの変更方法が知りたい Djangoには標準でログインなどの認証に使&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-allauth-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-allauth-guide/">django-allauthのデフォルト機能だけで高度な認証機能を実装する方法</a>
						<span class="p-blogCard__excerpt">django-allauthで認証を実装したい まずは基本の実装方法が知りたい Djangoはデフォルトでも認証機能を実装していますが、より高度な認証を行うにはdjango-allauthを使&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-allauth-admin-login-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-allauth-admin-login/">Google認証後に管理画面にログインできない【django-allauth】</a>
						<span class="p-blogCard__excerpt">Google認証で作ったユーザーで管理ページにログインしたい！ このような方に向けて書きました。 Google認証でユーザー作成すると、次の理由でDjangoの管理サイトにログ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-login-logout-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-login-logout/">【Django】ログイン・ログアウト機能と表示するページの制御方法</a>
						<span class="p-blogCard__excerpt">Django に認証機能を実装したい 認証状況ごとに表示するページを変えたい Djangoでは標準でログイン・ログアウト関連のモジュールが実装されています。 そのため、簡単&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Step 5：テンプレート・フロントと繋ぐ</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/08/python-django-templates-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-templates-guide/">【Django】テンプレート・静的ファイル完全ガイド｜継承・フィルタ・CSS/JS管理まで解説</a>
						<span class="p-blogCard__excerpt">Djangoのテンプレートを初めて触ったとき、普通のHTMLよりも少しオブジェクト指向的な考え方が必要で、理解するまで少し時間がかかりました。 変数を埋め込むだけならま&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-global-navigation-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-global-navigation/">【簡単】Djangoで基本のグローバルメニューを作る方法</a>
						<span class="p-blogCard__excerpt">Djangoでグローバルメニューを作りたい！ CSSファイルってどこに配置したら良いの？ このような疑問にお答えします。 テンプレートHTMLを作り込もうとした場合に、最初&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-tailwind-setup-300x171.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-tailwind-setup/">【TailwindCSS】 django-tailwind のセットアップ方法と使い方</a>
						<span class="p-blogCard__excerpt">Django で TailwindCSS を使いたい セットアップ手順は？ 簡単な使い方が知りたい 最近の求人を見渡していると、技術スタックで TailwindCSS を求められることが増えて&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-templates-ga4-setup-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-templates-ga4-setup/">DjangoテンプレートでGoogle Analytics（GA4）を実装する方法【本番のみ有効化】</a>
						<span class="p-blogCard__excerpt">GA4を環境変数でON/OFF制御したい 本番環境だけで計測したい メンテナンスコストを低く抑えたい このような方に向けて書きました。 Django プロジェクトに Google Analy&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/code-python-django-css-not-applied/">Django開発で「CSSが反映されない問題」を確実に解決する最小構成</a>
						<span class="p-blogCard__excerpt">スマホ実機・本番環境でもキャッシュを100%破壊する方法をご紹介します。 Django でスタイルを調整していると、CSS が反映されないことはよく遭遇します。 特にスマホ（&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Step 6：REST APIを公開する</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-rest-cors/">Django REST framework で CORS 対策をする方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で CORS エラーが出ている… このような場合の対策をお伝えします。 Django REST framework（以下「DRF」とします）では、外部ライブラリを使うこ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-rest-framework-basic-auth-method/">【Basic, Token, Session】デフォルトで用意された3つの認証クラス入門【Django REST Framework】</a>
						<span class="p-blogCard__excerpt">Django REST Framework（DRF）には、デフォルトで3つの認証機能が搭載されています。 認証機能は認証クラス(authentication classes)で設定し、リクエストが誰からのも&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-rest-framework-version-management/">APIのバージョン管理（/api/v1/…）設計方法【Django REST framework】</a>
						<span class="p-blogCard__excerpt">既存クライアントに影響を与えずにAPIの仕様を変更したい 複数バージョンをどのように分けて設計・管理すればよいか分からない 将来的な拡張を見据えて、最初から正しい&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-drf-upload-image/">【Django REST framework】画像ファイルアップロード機能の実装方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で画像アップロード機能を実装したい！ Django REST framework（以下、「DRF」とします）で画像アップロード機能を実装するには、いくつかのステ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">投稿が見つかりません。</div>

<div class="swell-block-postLink">投稿が見つかりません。</div>


<h3 class="wp-block-heading">Step 7：テストを書く</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-unit-test-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-unit-test/">【Django】ユニットテストを書く方法【単体テスト】</a>
						<span class="p-blogCard__excerpt">Django のテストコードってどう書けばいい？？ このような疑問にお答えします。 ユニットテストは「単体テスト」とも呼ばれ、クラスや関数などの狭い範囲のプログラムが&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Step 8：運用を効率化する</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-custom-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-custom-command/">【初心者でも簡単】Djangoカスタムコマンド入門</a>
						<span class="p-blogCard__excerpt">ルーティン作業を自動化したい カスタムコマンドを実装したい カスタムコマンドを使うと、あらかじめ書いたスクリプトを manage.py 経由で実行できます。 例えば、以下&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-djlint-setup-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-djlint-setup/">Django の djLint のセットアップ方法と使い方</a>
						<span class="p-blogCard__excerpt">Django のリンター djLint を使ってみたい 設定方法をサクッと知りたい djLint は Django でフォーマッター兼リンターとして使える便利なライブラリです。つまり Django&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Step 9：本番にデプロイする</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-django-xserver-vps-deploy-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-django-xserver-vps-deploy/">【お試し】エックスサーバーVPSにDjangoプロジェクトをデプロイする方法</a>
						<span class="p-blogCard__excerpt">DjangoをVPSにデプロイする流れが知りたい！ このようなDjango学習中の方に向けて書きました。 どうせDjangoを勉強するなら、サーバーにデプロイしてみたいですよね。 &#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/gunicorn-django-basics/">GunicornでDjangoプロジェクトをデプロイする方法【Nginx使用】</a>
						<span class="p-blogCard__excerpt">Gunicornの設定が難しすぎる… 動かすコマンドは？ 実践的な設定方法を教えて！ このような方に向けて書きました。 中小規模のDjangoアプリのデプロイによく使われるアプ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-certbot-https-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-certbot-https/">【Django + Let’s Encrypt】CerbotでHTTPS化するための手順</a>
						<span class="p-blogCard__excerpt">ブラウザで警告が表示されてる 暗号化されていないので不安 ユーザー管理しているのでちゃんとしておきたい サイトを公開後にまず取り組むべきは、HTTPS化です。 HTTPS&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-secret-key-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-secret-key/">【Django】SECRET_KEYを再生成する方法</a>
						<span class="p-blogCard__excerpt">まちがえてSECRET_KEYをGitHubにプッシュしてしまった！ Django標準の機能でSECRET_KEYを生成したい！ このような疑問にお答えします。 SECRET_KEYは、以下の条件を満た&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-sitemap-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-sitemap/">Djangoでサイトマップ（sitemap.xml）を実装する方法まとめ</a>
						<span class="p-blogCard__excerpt">検索エンジンに正しくクロールしてもらうために、Django が標準機能でサイトマップを生成する方法を整理します。 使うのはdjango.contrib.sitemaps です。 Django側の準&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-adstxt-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-adstxt/">【Django】Google AdSense の ads.txt をルートパスで配信する方法</a>
						<span class="p-blogCard__excerpt">Google AdSense を利用する時には、ads.txt をドメイン直下（/ads.txt）で公開する必要があります。 Django でサイトを構築していると、次のようなことで迷うことも多い&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">こんなことをしたい → どの記事を読む？逆引きナビ</h2>



<p class="wp-block-paragraph">「困りごとは決まっているけど、どこから読めばいいかわからない」という方向けに、トラブル対応系の記事をまとめました。</p>



<p class="wp-block-paragraph"><strong>開発サーバーが「ポートが使用中」と言われる</strong></p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/code-python-django-port-already-in-use/">【完全保存版】Djangoで「That port is already in use」エラーが出たときの対処法まとめ</a>
						<span class="p-blogCard__excerpt">Django 開発中に python manage.py runserver を実行したら、次のようなエラーに遭遇しましたか？ BashError: That port is already in use.Error: That port is alread&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph"><strong>リダイレクトの実装で迷っている</strong></p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/code-python-django-redirect/">【完全版】Djangoで使うリダイレクトの種類と判断基準・実装方法まとめ</a>
						<span class="p-blogCard__excerpt">URL 設計を途中で変更したい /old/ から /new/ に誘導したい pk URL を slug にリプレースしたい Webアプリを運用していると、こんな場面は必ず出てきます。 そのときに&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph"><strong>ローカル環境を外部に一時公開したい</strong></p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-ngrok/">【Django】ngrokを使ってローカル環境を外部公開する方法</a>
						<span class="p-blogCard__excerpt">ローカルの開発サーバーに外部からアクセスしたい Webhook のテストがしたい python manage.py runserver をすると開発用のローカルサーバーが立ち上がるのはご存知のと&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Djangoは、モデル・認証・管理画面といったWebアプリの土台がひと通り揃ったフレームワークです。このガイドで学んだことをまとめると、次のとおりです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>DjangoはModel・Template・Viewの3役割で構成される</li>

<li>言語・フレームワークは使い慣れたものを選べばよく、Djangoである必然性は特にない</li>

<li>フレームワーク特有の「お作法」は、理屈より先に一旦受け入れて動かしてみるのが近道</li>

<li>urls.pyとviews.pyの対応関係が、Djangoのリクエスト処理の骨格</li>

<li>各テーマの詳細は上のロードマップから学べる</li>
</ul>
</div></div>



<p class="wp-block-paragraph">実際に触ってみると、Djangoって意外と簡単だと感じてもらえるはずです。まずはプロジェクトを立ち上げるところから始めてみてください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-project-setup-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-project-setup/">【Django】プロジェクトとアプリの設定方法まとめ</a>
						<span class="p-blogCard__excerpt">Djangoの開発を始めるための準備が知りたい！ 普通にPythonでコーディングするのと違って、Djangoの開発では細々した準備が必要です。 内容をざっと列挙すると以下の通&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>FastAPI入門ガイド｜ルーティングの基本と依存関係の付き合い方</title>
		<link>https://cfxlog.com/python-fastapi-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 31 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[FastAPI]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[Webアプリ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/python-fastapi-guide/</guid>

					<description><![CDATA[このような疑問にお答えします。 FastAPIは、Pythonで書けるAPI特化のWebフレームワークです。型ヒントをベースにしたバリデーションと、自動生成されるAPIドキュメントが特徴です。 このガイドでは、FastA [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>FastAPIって何がうれしいの？</li>

<li>Djangoとどう違うのか、どっちを使えばいいのかわからない</li>

<li>ライブラリの組み合わせが多くて、環境構築でつまずきそう</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">FastAPIは、Pythonで書けるAPI特化のWebフレームワークです。型ヒントをベースにしたバリデーションと、自動生成されるAPIドキュメントが特徴です。</p>



<p class="wp-block-paragraph">このガイドでは、<strong>FastAPIの基本的な考え方から、実際にAPIを1つ動かすところまで</strong>を解説します。後半には関連記事へのロードマップも用意しています。</p>



<h2 class="wp-block-heading">FastAPIとは何か</h2>



<p class="wp-block-paragraph">FastAPIは、Pythonの型ヒントを使ってAPIのリクエスト・レスポンスを定義するWebフレームワークです。型ヒントを書くだけで、リクエストデータのバリデーションと、Swagger UIによる対話的なAPIドキュメントが自動生成されます。</p>



<p class="wp-block-paragraph">DjangoがWebアプリ全般を想定した「フルスタック」寄りのフレームワークなのに対し、FastAPIはAPIサーバーに機能を絞っています。管理画面やテンプレートエンジンは標準では付いてきません。</p>



<h3 class="wp-block-heading">正直、僕はFastAPIを自分から選ぶことはあまりない</h3>



<p class="wp-block-paragraph">正直に言うと、僕は普段からFastAPIを積極的に選ぶタイプではありません。案件やプロジェクトで既にFastAPIが採用されていて、それに対応する形で触ることがほとんどです。</p>



<p class="wp-block-paragraph">とはいえ、慣れてしまえば身構えるほどのフレームワークでもありません。このガイドは「自分から選んで学ぶ人」よりも、「必要になったから触ることになった人」を想定して書いています。</p>



<h2 class="wp-block-heading">FastAPIを始める前に知っておきたいこと</h2>



<p class="wp-block-paragraph">FastAPI自体はシンプルですが、実際に動かすにはUvicorn（ASGIサーバー）やPydantic（データ検証）など、いくつかのライブラリを組み合わせる必要があります。</p>



<p class="wp-block-paragraph">ここが最初につまずきやすいポイントです。僕自身、Djangoのように機能がひとつにまとまっている感覚でいたので、複数のライブラリの依存関係やバージョンの組み合わせを自分で把握する必要がある点の取り回しに、最初は戸惑いました。</p>



<p class="wp-block-paragraph">ただ、これは裏を返せば「必要なものだけ組み合わせられる」ということでもあります。最初の環境構築さえ乗り切れば、あとの学習コストはそこまで高くありません。</p>



<h2 class="wp-block-heading">はじめてのAPIを書いてみよう</h2>



<p class="wp-block-paragraph">理屈より先に、実際に動くAPIを見てみましょう。GETリクエストを受けてJSONを返す、最小構成の例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI

app = FastAPI()

@app.get("/hello")
def hello():
    return {"message": "Hello, FastAPI!"}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> fastapi </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#DCDCAA">@app.get</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"/hello"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> hello</span><span style="color:#D4D4D4">():</span></span>
<span class="line"><span style="color:#C586C0">    return</span><span style="color:#D4D4D4"> {</span><span style="color:#CE9178">"message"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"Hello, FastAPI!"</span><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>@app.get("/hello")</code>のようにデコレータでパスとHTTPメソッドを指定するだけで、ルーティングが完成します。関数の戻り値をそのままJSONとして返してくれるので、レスポンスの組み立てで悩むこともありません。</p>



<h2 class="wp-block-heading">関連記事</h2>



<p class="wp-block-paragraph">基本が掴めたら、以下の記事でさらに実践的な使い方を解説しています。モデル設計・DB連携・認証・デプロイ編は現在準備中です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-fastapi-quickstart-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-fastapi-quickstart/">【入門編】FastAPIスピードマスターガイド</a>
						<span class="p-blogCard__excerpt">FastAPIの概要を知りたい 公式チュートリアルを読むのが面倒 簡単な使い方をマスターしたい FastAPI はフルスタックフレームワークの Django に比べると直感的かつシン&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-fastapi-routing-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-fastapi-routing/">【FastAPI】API ルーティングの設計について徹底解説！</a>
						<span class="p-blogCard__excerpt">FastAPI のルーティングの方法が知りたい バリデーションってどうやるの？ このような疑問にお答えします。 FastAPI では関数を使ってルーティングを表現するので、端的&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">FastAPIは、型ヒントベースのバリデーションと自動ドキュメント生成が武器のAPIフレームワークです。このガイドで押さえておきたい点は次のとおりです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>FastAPIはAPIに特化した軽量フレームワーク。Djangoほどオールインワンではない</li>

<li>最初のハードルはライブラリの組み合わせ・依存関係の把握</li>

<li>ルーティングはデコレータで書き、戻り値がそのままJSONになる</li>
</ul>
</div></div>



<p class="wp-block-paragraph">依存関係さえ乗り越えれば、FastAPIは実は簡単です。プロジェクトで必要になったタイミングで、気負わず触ってみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js JWT認証の実装｜アクセストークンをメモリ管理・リフレッシュ並走バグを防ぐmutexパターン</title>
		<link>https://cfxlog.com/nextjs-jwt-memory-token-auth/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 12 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Next.js]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nextjs-jwt-memory-token-auth/</guid>

					<description><![CDATA[この記事は、Next.js + Django JWT認証シリーズのフロントエンド実装編です。設計の考え方は下記の記事で解説しています。 TypeScriptで実装します。ファイル名は lib/auth.ts として、認証 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Next.jsでJWTトークンをどこに保存すればいいか知りたい</li>



<li>複数リクエストが同時にリフレッシュを呼んでエラーになる問題を解決したい</li>



<li>401レスポンスを受け取ったときに自動でリトライする仕組みを作りたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事は、Next.js + Django JWT認証シリーズのフロントエンド実装編です。設計の考え方は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-django-jwt-auth-design/">Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</a>
						<span class="p-blogCard__excerpt">JWTをlocalStorageに保存していいのか不安 アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい XSSとCSRFを両方対策した設計の考え方を理解したい JW&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">TypeScriptで実装します。ファイル名は <code>lib/auth.ts</code> として、認証に関わる関数をすべてここにまとめます。</p>



<h2 class="wp-block-heading">アクセストークンをメモリに保持する</h2>



<p class="wp-block-paragraph">アクセストークンはモジュールスコープの変数に保存します。localStorageやsessionStorageを使わないことがXSS対策の核心です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// モジュールスコープの変数でメモリ管理する
let accessTokenInMemory: string | null = null;

export const getAccessToken = () => accessTokenInMemory;
export const setAccessToken = (t: string | null) => {
  accessTokenInMemory = t;
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// モジュールスコープの変数でメモリ管理する</span></span>
<span class="line"><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4"> = (</span><span style="color: #9CDCFE">t</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4">) </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">t</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">モジュールスコープの変数はページをリロードすると消えます。ただし、有効なリフレッシュCookieがあればページ初期化時に自動で復元されます。この仕組みは後述の <code>initializeAuth()</code> で実装します。</p>



<h2 class="wp-block-heading">localStorageはセッションフラグだけに使う</h2>



<p class="wp-block-paragraph">HttpOnly CookieはJavaScriptから読めないため、ログイン済みかどうかを確認する手段がありません。そこで「セッションが存在するかどうか」というboolean値だけをlocalStorageに保存します。トークン本体は絶対に保存しません。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>const SESSION_FLAG = 'has_session';

// ログイン時に呼ぶ
export const markSessionActive = () => {
  try { localStorage.setItem(SESSION_FLAG, '1'); } catch { /* ignore */ }
};

// ログアウト時に呼ぶ
export const clearSessionFlag = () => {
  try { localStorage.removeItem(SESSION_FLAG); } catch { /* ignore */ }
};

// ログイン済みかどうかのヒントとして使う
export const hasSessionFlag = (): boolean => {
  try { return localStorage.getItem(SESSION_FLAG) === '1'; } catch { return false; }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&apos;has_session&apos;</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログイン時に呼ぶ</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">markSessionActive</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">setItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&apos;1&apos;</span><span style="color: #D4D4D4">); } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #6A9955">/* ignore */</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログアウト時に呼ぶ</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">clearSessionFlag</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">removeItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">); } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #6A9955">/* ignore */</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログイン済みかどうかのヒントとして使う</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">hasSessionFlag</span><span style="color: #D4D4D4"> = (): </span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">getItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">) === </span><span style="color: #CE9178">&apos;1&apos;</span><span style="color: #D4D4D4">; } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">; }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">このフラグはUIの表示切り替え（ログイン状態の初期判定）に使うもので、実際のAPIリクエストの認証はメモリ上のアクセストークンで行います。</p>



<h2 class="wp-block-heading">CSRF トークンの取得</h2>



<p class="wp-block-paragraph">DjangoはCSRF保護が有効なため、POSTリクエストには <code>X-CSRFToken</code> ヘッダーが必要です。まずCookie からCSRFトークンを読む関数を用意し、次にCSRF Cookieを取得するエンドポイントを呼び出す関数を作ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// document.cookie からCSRFトークンを読む
const getCookie = (name: string): string | null => {
  const m = document.cookie.match(new RegExp(`(?:^|; )${name}=(&#91;^;&#93;*)`))
  return m ? decodeURIComponent(m&#91;1&#93;) : null
}

// ページ初期化時に1回だけ呼んでCSRF Cookieをセットする
export const fetchCsrfCookie = async () => {
  try {
    await fetch('/auth/csrf_cookie/', {
      method: 'GET',
      credentials: 'include',
    })
  } catch {
    // 広告ブロッカー等でブロックされる可能性があるため静かに失敗させる
  }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// document.cookie からCSRFトークンを読む</span></span>
<span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4"> = (</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">): </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">m</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">document</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">cookie</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">match</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">RegExp</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`(?:^|; )</span><span style="color: #569CD6">${</span><span style="color: #9CDCFE">name</span><span style="color: #569CD6">}</span><span style="color: #CE9178">=(&#91;^;&#93;*)`</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">m</span><span style="color: #D4D4D4"> ? </span><span style="color: #DCDCAA">decodeURIComponent</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">m</span><span style="color: #D4D4D4">&#91;</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">&#93;) : </span><span style="color: #569CD6">null</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ページ初期化時に1回だけ呼んでCSRF Cookieをセットする</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetchCsrfCookie</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;/auth/csrf_cookie/&apos;</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;GET&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    })</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 広告ブロッカー等でブロックされる可能性があるため静かに失敗させる</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<h2 class="wp-block-heading">refreshToken() の並走対策（mutex）</h2>



<p class="wp-block-paragraph">ここがこの実装の核心部分です。<code>ROTATE_REFRESH_TOKENS = True</code> の環境では、複数のリクエストが同時に <code>refreshToken()</code> を呼び出すと競合が起きます。</p>



<p class="wp-block-paragraph">対策は、進行中のリフレッシュリクエストをモジュールスコープ変数に保持し、2回目以降の呼び出しでは同じPromiseを返すことです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// 進行中のリフレッシュリクエストを保持する（mutexとして機能する）
let refreshingPromise: Promise&lt;boolean> | null = null;

export const refreshToken = (): Promise&lt;boolean> => {
  // 既に進行中なら同じPromiseを返す（新たにリクエストを送らない）
  if (refreshingPromise) return refreshingPromise;

  refreshingPromise = (async () => {
    try {
      const res = await fetch('/auth/jwt/refresh/', {
        method: 'POST',
        credentials: 'include', // HttpOnly Cookieをブラウザが自動送信
        headers: {
          'Content-Type': 'application/json',
          'X-CSRFToken': getCookie('csrftoken') ?? '',
        },
        body: JSON.stringify({}),
      });
      if (!res.ok) return false;
      const data = await res.json() as { access?: string };
      if (data?.access) setAccessToken(data.access);
      return !!data?.access;
    } catch {
      return false;
    } finally {
      // 成功・失敗にかかわらず次の呼び出しに備えてリセット
      refreshingPromise = null;
    }
  })();

  return refreshingPromise;
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// 進行中のリフレッシュリクエストを保持する（mutexとして機能する）</span></span>
<span class="line"><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4">&gt; | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4"> = (): </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4">&gt; </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 既に進行中なら同じPromiseを返す（新たにリクエストを送らない）</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4"> = (</span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;/auth/jwt/refresh/&apos;</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #6A9955">// HttpOnly Cookieをブラウザが自動送信</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">          </span><span style="color: #CE9178">&apos;Content-Type&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;application/json&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">          </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        },</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">body:</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">JSON</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">stringify</span><span style="color: #D4D4D4">({}),</span></span>
<span class="line"><span style="color: #D4D4D4">      });</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">ok</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">data</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">json</span><span style="color: #D4D4D4">() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">?: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> };</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">?.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">) </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> !!</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">?.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    } </span><span style="color: #C586C0">finally</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #6A9955">// 成功・失敗にかかわらず次の呼び出しに備えてリセット</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    }</span></span>
<span class="line"><span style="color: #D4D4D4">  })();</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">3つのリクエストが同時に401を受け取って <code>refreshToken()</code> を呼び出したとしても、実際にサーバーへ送るリフレッシュリクエストは1本だけになります。他の2本は同じPromiseを待つため、競合が起きません。</p>



<h2 class="wp-block-heading">apiFetch() で 401 を自動リトライする</h2>



<p class="wp-block-paragraph">APIリクエストのラッパー関数を実装します。401レスポンスを受け取ったら自動でリフレッシュし、元のリクエストを再実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL ?? '';

export async function apiFetch(input: string, init: RequestInit = {}) {
  const headers = new Headers(init.headers);
  const token = getAccessToken();
  if (token) headers.set('Authorization', `Bearer ${token}`);

  let res = await fetch(`${API_BASE_URL}${input}`, {
    ...init,
    headers,
    credentials: 'include',
  });

  // 401以外はそのまま返す
  if (res.status !== 401) return res;

  // アクセストークン切れ → リフレッシュしてリトライ
  const refreshed = await refreshToken();
  if (!refreshed) return res; // リフレッシュも失敗したら元の401を返す

  // 新しいアクセストークンで再リクエスト
  headers.set('Authorization', `Bearer ${getAccessToken()}`);
  return fetch(`${API_BASE_URL}${input}`, { ...init, headers, credentials: 'include' });
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">process</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">env</span><span style="color: #D4D4D4">.</span><span style="color: #4FC1FF">NEXT_PUBLIC_API_URL</span><span style="color: #D4D4D4"> ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">function</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">apiFetch</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">input</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">RequestInit</span><span style="color: #D4D4D4"> = {}) {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">headers</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Headers</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">token</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">token</span><span style="color: #D4D4D4">) </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">set</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;Authorization&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">`Bearer </span><span style="color: #569CD6">${</span><span style="color: #9CDCFE">token</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">);</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}${</span><span style="color: #9CDCFE">input</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  });</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 401以外はそのまま返す</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">status</span><span style="color: #D4D4D4"> !== </span><span style="color: #B5CEA8">401</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// アクセストークン切れ → リフレッシュしてリトライ</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">refreshed</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">refreshed</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">; </span><span style="color: #6A9955">// リフレッシュも失敗したら元の401を返す</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 新しいアクセストークンで再リクエスト</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">set</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;Authorization&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">`Bearer </span><span style="color: #569CD6">${</span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4">()</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}${</span><span style="color: #9CDCFE">input</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">, { ...</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4"> });</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">呼び出し側は通常の <code>fetch()</code> と同じ感覚で使えます。401ハンドリングを意識する必要がなく、コードがシンプルに保てます。</p>



<h2 class="wp-block-heading">ログイン・ログアウトの実装</h2>



<p class="wp-block-paragraph">ログインはDjoserの <code>/auth/jwt/create/</code> を呼び出します。アクセストークンをメモリに保存し、セッションフラグを立てます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>export const login = async (email: string, password: string) => {
  const res = await fetch(`${API_BASE_URL}/auth/jwt/create/`, {
    method: 'POST',
    credentials: 'include',
    headers: {
      'Content-Type': 'application/json',
      'X-CSRFToken': getCookie('csrftoken') ?? '',
    },
    body: JSON.stringify({ email, password }),
  });
  if (!res.ok) throw new Error('ログインに失敗しました');
  const data = await res.json() as { access: string };
  setAccessToken(data.access);
  markSessionActive();
  return data;
};

export const logout = async () => {
  try {
    await fetch(`${API_BASE_URL}/auth/logout/`, {
      method: 'POST',
      credentials: 'include',
      headers: { 'X-CSRFToken': getCookie('csrftoken') ?? '' },
    });
  } finally {
    // サーバー側の処理が失敗してもローカルはクリアする
    setAccessToken(null);
    clearSessionFlag();
  }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">login</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">email</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">password</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">) </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}</span><span style="color: #CE9178">/auth/jwt/create/`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&apos;Content-Type&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;application/json&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    },</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">body:</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">JSON</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">stringify</span><span style="color: #D4D4D4">({ </span><span style="color: #9CDCFE">email</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">password</span><span style="color: #D4D4D4"> }),</span></span>
<span class="line"><span style="color: #D4D4D4">  });</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">ok</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">throw</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Error</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;ログインに失敗しました&apos;</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">data</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">json</span><span style="color: #D4D4D4">() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> };</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #DCDCAA">markSessionActive</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">logout</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}</span><span style="color: #CE9178">/auth/logout/`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> { </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4"> },</span></span>
<span class="line"><span style="color: #D4D4D4">    });</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">finally</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// サーバー側の処理が失敗してもローカルはクリアする</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">clearSessionFlag</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">ログアウトは <code>try...finally</code> を使い、サーバー側のブラックリスト登録が失敗してもローカルのアクセストークンとセッションフラグは必ずクリアします。</p>



<h2 class="wp-block-heading">ページ初期化時の認証復元（initializeAuth）</h2>



<p class="wp-block-paragraph">ページをリロードするとメモリ上のアクセストークンが消えます。有効なリフレッシュCookieがあれば自動で復元できるよう、アプリ起動時に一度だけ呼ぶ初期化関数を用意します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>export const initializeAuth = async (): Promise&lt;void> => {
  try {
    // 1. CSRF Cookieを取得する（POSTリクエストに必要）
    await fetchCsrfCookie();
    // 2. リフレッシュCookieでアクセストークンを復元する
    await refreshToken();
  } catch (e) {
    console.warn('initializeAuth failed', e);
  }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">initializeAuth</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> (): </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">void</span><span style="color: #D4D4D4">&gt; </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 1. CSRF Cookieを取得する（POSTリクエストに必要）</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetchCsrfCookie</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 2. リフレッシュCookieでアクセストークンを復元する</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">e</span><span style="color: #D4D4D4">) {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">console</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">warn</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;initializeAuth failed&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">e</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">Next.jsのApp Routerを使っている場合、ルートの <code>layout.tsx</code> に配置した <code>AuthProvider</code> などのクライアントコンポーネントから <code>useEffect(() =&gt; { initializeAuth(); }, [])</code> で呼び出します。</p>



<p class="wp-block-paragraph">リフレッシュCookieが有効期限切れの場合は <code>refreshToken()</code> が <code>false</code> を返します。この場合はアクセストークンが復元されず、ユーザーは未ログイン状態になります。</p>



<h2 class="wp-block-heading">まとめ：この実装で防げること</h2>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>XSSによるトークン盗取</strong><br>アクセストークンはメモリのみ。リフレッシュトークンはHttpOnly Cookie。どちらもXSSスクリプトから直接読み出せない。</li>



<li><strong>CSRF攻撃</strong><br>アクセストークンはAuthorizationヘッダー送信のみ。リフレッシュCookieのパスは <code>/auth/</code> に限定されているため、API全体をCSRFで叩くことができない。</li>



<li><strong>リフレッシュの並走競合</strong><br>mutexパターンにより、同時に何本のリクエストが来ても実際のリフレッシュAPIは1本のみ実行される。</li>



<li><strong>アクセストークン期限切れによるエラー</strong><br><code>apiFetch()</code> が自動でリフレッシュ＆リトライするため、呼び出し側で期限切れを意識しなくてよい。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">バックエンド（Django）側の設定は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-simplejwt-djoser-setup/">Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</a>
						<span class="p-blogCard__excerpt">DjangoでJWT認証を実装したい SimpleJWTとDjoserをどう組み合わせるか知りたい 不要なエンドポイントを封鎖してセキュリティを高めたい この記事は、Next.js + Django J&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</title>
		<link>https://cfxlog.com/django-simplejwt-djoser-setup/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 14 May 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/django-simplejwt-djoser-setup/</guid>

					<description><![CDATA[この記事は、Next.js + Django JWT認証シリーズのバックエンド実装編です。設計の考え方は下記の記事で解説しています。 この記事では、djangorestframework-simplejwt と djos [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>DjangoでJWT認証を実装したい</li>

<li>SimpleJWTとDjoserをどう組み合わせるか知りたい</li>

<li>不要なエンドポイントを封鎖してセキュリティを高めたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事は、Next.js + Django JWT認証シリーズのバックエンド実装編です。設計の考え方は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-django-jwt-auth-design/">Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</a>
						<span class="p-blogCard__excerpt">JWTをlocalStorageに保存していいのか不安 アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい XSSとCSRFを両方対策した設計の考え方を理解したい JW&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">この記事では、<code>djangorestframework-simplejwt</code> と <code>djoser</code> の設定、Redisを使ったレートリミットミドルウェアの実装を解説します。</p>



<h2 class="wp-block-heading">必要なパッケージ</h2>



<p class="wp-block-paragraph">JWT認証に必要なパッケージを追加します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>djangorestframework-simplejwt</strong><br>JWTの発行・検証・リフレッシュ・ブラックリスト管理を担う。</li>

<li><strong>djoser</strong><br>ユーザー登録・ログイン・パスワードリセットなどの認証エンドポイントを提供するライブラリ。SimpleJWTと組み合わせて使う。</li>

<li><strong>django-redis</strong><br>RedisをDjangoのキャッシュバックエンドとして使うためのパッケージ。レートリミットのカウンターをマルチワーカー間で共有できる。</li>

<li><strong>django-environ</strong><br>環境変数を <code>.env</code> ファイルから読み込むユーティリティ。</li>
</ul>
</div></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># uv を使う場合
uv add djangorestframework djangorestframework-simplejwt djoser django-redis django-environ

# pip を使う場合
pip install djangorestframework djangorestframework-simplejwt djoser django-redis django-environ</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># uv を使う場合</span></span>
<span class="line"><span style="color:#DCDCAA">uv</span><span style="color:#CE9178"> add</span><span style="color:#CE9178"> djangorestframework</span><span style="color:#CE9178"> djangorestframework-simplejwt</span><span style="color:#CE9178"> djoser</span><span style="color:#CE9178"> django-redis</span><span style="color:#CE9178"> django-environ</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># pip を使う場合</span></span>
<span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> djangorestframework</span><span style="color:#CE9178"> djangorestframework-simplejwt</span><span style="color:#CE9178"> djoser</span><span style="color:#CE9178"> django-redis</span><span style="color:#CE9178"> django-environ</span></span></code></pre></div>



<h2 class="wp-block-heading">INSTALLED_APPS と MIDDLEWARE の設定</h2>



<p class="wp-block-paragraph">インストールしたパッケージを <code>INSTALLED_APPS</code> に追加します。<code>rest_framework_simplejwt.token_blacklist</code> はリフレッシュトークンのローテーション時に古いトークンを無効化するために必要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    # サードパーティ
    "corsheaders",
    "rest_framework",
    "rest_framework_simplejwt",
    "rest_framework_simplejwt.token_blacklist",
    "djoser",
    # ローカルアプリ
    "apps.users",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">INSTALLED_APPS = [</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.admin"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.auth"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.contenttypes"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.sessions"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.messages"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.staticfiles"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # サードパーティ</span></span>
<span class="line"><span style="color:#CE9178">    "corsheaders"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework_simplejwt"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework_simplejwt.token_blacklist"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "djoser"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # ローカルアプリ</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>MIDDLEWARE</code> には <code>CorsMiddleware</code> を最上位に、カスタムミドルウェアを末尾に追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>MIDDLEWARE = [
    "corsheaders.middleware.CorsMiddleware",  # 最上位に置く
    "django.middleware.security.SecurityMiddleware",
    "whitenoise.middleware.WhiteNoiseMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "django.contrib.auth.middleware.AuthenticationMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
    # カスタム
    "apps.users.middleware.RateLimitMiddleware",
    "apps.users.middleware.SecurityHeadersMiddleware",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">MIDDLEWARE = [</span></span>
<span class="line"><span style="color:#CE9178">    "corsheaders.middleware.CorsMiddleware"</span><span style="color:#D4D4D4">,  </span><span style="color:#6A9955"># 最上位に置く</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.security.SecurityMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "whitenoise.middleware.WhiteNoiseMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.sessions.middleware.SessionMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.common.CommonMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.csrf.CsrfViewMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.auth.middleware.AuthenticationMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.messages.middleware.MessageMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.clickjacking.XFrameOptionsMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # カスタム</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users.middleware.RateLimitMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users.middleware.SecurityHeadersMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h2 class="wp-block-heading">REST_FRAMEWORK の設定</h2>



<p class="wp-block-paragraph">デフォルトの認証クラスを <code>JWTAuthentication</code> のみにします。Sessionなど不要な認証方式を残すとセキュリティ上のリスクになるため削除します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>REST_FRAMEWORK = {
    "DEFAULT_AUTHENTICATION_CLASSES": [
        "rest_framework_simplejwt.authentication.JWTAuthentication",
    ],
    "DEFAULT_PERMISSION_CLASSES": [
        "rest_framework.permissions.IsAuthenticated",
    ],
    "DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
    "PAGE_SIZE": 20,
    "DEFAULT_RENDERER_CLASSES": [
        "rest_framework.renderers.JSONRenderer",
    ],
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">REST_FRAMEWORK = {</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_AUTHENTICATION_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework_simplejwt.authentication.JWTAuthentication"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_PERMISSION_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework.permissions.IsAuthenticated"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_PAGINATION_CLASS"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"rest_framework.pagination.PageNumberPagination"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "PAGE_SIZE"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">20</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_RENDERER_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework.renderers.JSONRenderer"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<h2 class="wp-block-heading">SimpleJWT の設定</h2>



<p class="wp-block-paragraph">トークンの有効期限とローテーション設定が中心です。各パラメータの意味を確認しておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from datetime import timedelta

SIMPLE_JWT = {
    # アクセストークン: 15分（短命にしてリスクを限定）
    "ACCESS_TOKEN_LIFETIME": timedelta(minutes=15),
    # リフレッシュトークン: 14日
    "REFRESH_TOKEN_LIFETIME": timedelta(days=14),
    # リフレッシュのたびに新しいリフレッシュトークンを発行
    "ROTATE_REFRESH_TOKENS": True,
    # 使用済みリフレッシュトークンをブラックリストに登録
    "BLACKLIST_AFTER_ROTATION": True,
    "AUTH_HEADER_TYPES": ("Bearer",),
    "TOKEN_TYPE_CLAIM": "token_type",
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> datetime </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> timedelta</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">SIMPLE_JWT = {</span></span>
<span class="line"><span style="color:#6A9955">    # アクセストークン: 15分（短命にしてリスクを限定）</span></span>
<span class="line"><span style="color:#CE9178">    "ACCESS_TOKEN_LIFETIME"</span><span style="color:#D4D4D4">: timedelta(</span><span style="color:#9CDCFE">minutes</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">15</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#6A9955">    # リフレッシュトークン: 14日</span></span>
<span class="line"><span style="color:#CE9178">    "REFRESH_TOKEN_LIFETIME"</span><span style="color:#D4D4D4">: timedelta(</span><span style="color:#9CDCFE">days</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">14</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#6A9955">    # リフレッシュのたびに新しいリフレッシュトークンを発行</span></span>
<span class="line"><span style="color:#CE9178">    "ROTATE_REFRESH_TOKENS"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # 使用済みリフレッシュトークンをブラックリストに登録</span></span>
<span class="line"><span style="color:#CE9178">    "BLACKLIST_AFTER_ROTATION"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "AUTH_HEADER_TYPES"</span><span style="color:#D4D4D4">: (</span><span style="color:#CE9178">"Bearer"</span><span style="color:#D4D4D4">,),</span></span>
<span class="line"><span style="color:#CE9178">    "TOKEN_TYPE_CLAIM"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"token_type"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>ROTATE_REFRESH_TOKENS = True</code> を設定すると、リフレッシュのたびに新しいリフレッシュトークンが発行されます。古いトークンがブラックリストに入るため、トークン漏洩時の被害を限定できます。</p>



<p class="wp-block-paragraph">ただし、フロントエンドで複数のAPIリクエストが並走してリフレッシュを呼び出すと競合が起きます。この問題の対策はフロントエンド実装の記事で解説します。</p>



<h2 class="wp-block-heading">Djoser の設定 &#8211; 不要なエンドポイントを封鎖する</h2>



<p class="wp-block-paragraph">Djoserはデフォルトでユーザー登録・削除・メール変更など多くのエンドポイントを公開します。使わないエンドポイントを <code>IsAdminUser</code> で封鎖することが重要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>DJOSER = {
    "SERIALIZERS": {
        "current_user": "apps.users.serializers.UserProfileSerializer",
    },
    "PERMISSIONS": {
        "current_user": ["rest_framework.permissions.IsAuthenticated"],
        # /auth/users/ への直接登録を禁止（独自の承認フローを使うため）
        "user_create": ["rest_framework.permissions.IsAdminUser"],
        # メールアドレス変更を禁止（乗っ取り時に元オーナーが復旧できなくなるため）
        "set_username": ["rest_framework.permissions.IsAdminUser"],
        # 自己削除を禁止（関連データが失われるため）
        "user_delete": ["rest_framework.permissions.IsAdminUser"],
        # djoser標準のパスワードリセットを封鎖（独自実装を使うため）
        "password_reset": ["rest_framework.permissions.IsAdminUser"],
        "password_reset_confirm": ["rest_framework.permissions.IsAdminUser"],
    },
    # ユーザー列挙攻撃を防ぐ（未登録メールでも同じレスポンスを返す）
    "PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND": False,
    "USERNAME_RESET_SHOW_EMAIL_NOT_FOUND": False,
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">DJOSER = {</span></span>
<span class="line"><span style="color:#CE9178">    "SERIALIZERS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "current_user"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"apps.users.serializers.UserProfileSerializer"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    },</span></span>
<span class="line"><span style="color:#CE9178">    "PERMISSIONS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "current_user"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAuthenticated"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # /auth/users/ への直接登録を禁止（独自の承認フローを使うため）</span></span>
<span class="line"><span style="color:#CE9178">        "user_create"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # メールアドレス変更を禁止（乗っ取り時に元オーナーが復旧できなくなるため）</span></span>
<span class="line"><span style="color:#CE9178">        "set_username"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # 自己削除を禁止（関連データが失われるため）</span></span>
<span class="line"><span style="color:#CE9178">        "user_delete"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # djoser標準のパスワードリセットを封鎖（独自実装を使うため）</span></span>
<span class="line"><span style="color:#CE9178">        "password_reset"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#CE9178">        "password_reset_confirm"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#D4D4D4">    },</span></span>
<span class="line"><span style="color:#6A9955">    # ユーザー列挙攻撃を防ぐ（未登録メールでも同じレスポンスを返す）</span></span>
<span class="line"><span style="color:#CE9178">    "PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">False</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "USERNAME_RESET_SHOW_EMAIL_NOT_FOUND"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">False</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">特に <code>PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND = False</code> は重要です。これを有効にしないと、未登録のメールアドレスを送信したときに「そのメールは登録されていません」というレスポンスが返り、攻撃者にユーザー一覧を推測させてしまいます。</p>



<h2 class="wp-block-heading">Redis キャッシュの設定</h2>



<p class="wp-block-paragraph">レートリミットのカウンターをマルチワーカー間で共有するために、Redisをキャッシュバックエンドとして使います。Gunicornなど複数ワーカーを立てる場合に必要な設定です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" data-code="import environ
env = environ.Env()

REDIS_URL = env(&quot;REDIS_URL&quot;, default=&quot;redis://localhost:6379/1&quot;)
CACHES = {
    &quot;default&quot;: {
        &quot;BACKEND&quot;: &quot;django_redis.cache.RedisCache&quot;,
        &quot;LOCATION&quot;: REDIS_URL,
        &quot;OPTIONS&quot;: {
            &quot;CLIENT_CLASS&quot;: &quot;django_redis.client.DefaultClient&quot;,
        },
    }
}" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> environ</span></span>
<span class="line"><span style="color:#D4D4D4">env = environ.Env()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">REDIS_URL = env(</span><span style="color:#CE9178">"REDIS_URL"</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">default</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"redis://localhost:6379/1"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">CACHES = {</span></span>
<span class="line"><span style="color:#CE9178">    "default"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "BACKEND"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"django_redis.cache.RedisCache"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">        "LOCATION"</span><span style="color:#D4D4D4">: REDIS_URL,</span></span>
<span class="line"><span style="color:#CE9178">        "OPTIONS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">            "CLIENT_CLASS"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"django_redis.client.DefaultClient"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">        },</span></span>
<span class="line"><span style="color:#D4D4D4">    }</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<h2 class="wp-block-heading">RateLimitMiddleware の実装</h2>



<p class="wp-block-paragraph">Redisキャッシュを使ってIPアドレスごとにリクエスト数を制限するカスタムミドルウェアを実装します。<code>cache.add()</code> と <code>cache.incr()</code> を組み合わせることで、レースコンディションが起きないアトミックな実装になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import json
from django.conf import settings
from django.core.cache import cache
from django.http import HttpResponse
from django.utils.deprecation import MiddlewareMixin


class RateLimitMiddleware(MiddlewareMixin):
    def __init__(self, get_response):
        super().__init__(get_response)
        auth_req = 120 if settings.DEBUG else 30
        self.rate_limits = {
            "default":  {"requests": 100, "window": 60},
            "auth":     {"requests": auth_req, "window": 60},
            "register": {"requests": 5,   "window": 3600},
            "contact":  {"requests": 5,   "window": 3600},
        }

    def process_request(self, request):
        exempt = ["/static/", "/media/", "/favicon.ico", "/admin/"]
        if any(request.path.startswith(p) for p in exempt):
            return None
        ip = self._get_client_ip(request)
        endpoint = self._get_endpoint_type(request.path)
        if not self._check_rate_limit(ip, endpoint):
            return HttpResponse(
                json.dumps({"detail": "Rate limit exceeded."}),
                content_type="application/json",
                status=429,
            )
        return None

    def _get_client_ip(self, request):
        """リバースプロキシ経由の実クライアントIPを取得する"""
        remote_addr = request.META.get("REMOTE_ADDR", "")
        trusted = getattr(settings, "TRUSTED_PROXIES", [])
        if remote_addr in trusted:
            xff = request.META.get("HTTP_X_FORWARDED_FOR", "")
            if xff:
                # nginx は実クライアントIPを末尾に追記する
                return xff.split(",")[-1].strip()
        return remote_addr

    def _get_endpoint_type(self, path):
        if "/api/auth/register/" in path:
            return "register"
        if "/auth/" in path or "/login" in path:
            return "auth"
        if "/api/contact/" in path:
            return "contact"
        return "default"

    def _check_rate_limit(self, ip, endpoint):
        """アトミックなカウントアップで競合を防ぐ"""
        config = self.rate_limits.get(endpoint, self.rate_limits["default"])
        key = f"rate_limit:{endpoint}:{ip}"
        # キーが存在しない場合のみ0で初期化（TTL付き）
        cache.add(key, 0, config["window"])
        # アトミックにインクリメント
        count = cache.incr(key)
        return count &lt;= config["requests"]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> json</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.conf </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> settings</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.core.cache </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> cache</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.http </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> HttpResponse</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.utils.deprecation </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> MiddlewareMixin</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> RateLimitMiddleware</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">MiddlewareMixin</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> __init__</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">get_response</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#4EC9B0">        super</span><span style="color:#D4D4D4">().</span><span style="color:#DCDCAA">__init__</span><span style="color:#D4D4D4">(get_response)</span></span>
<span class="line"><span style="color:#D4D4D4">        auth_req = </span><span style="color:#B5CEA8">120</span><span style="color:#C586C0"> if</span><span style="color:#D4D4D4"> settings.DEBUG </span><span style="color:#C586C0">else</span><span style="color:#B5CEA8"> 30</span></span>
<span class="line"><span style="color:#569CD6">        self</span><span style="color:#D4D4D4">.rate_limits = {</span></span>
<span class="line"><span style="color:#CE9178">            "default"</span><span style="color:#D4D4D4">:  {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">60</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "auth"</span><span style="color:#D4D4D4">:     {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: auth_req, </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">60</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "register"</span><span style="color:#D4D4D4">: {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">5</span><span style="color:#D4D4D4">,   </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">3600</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "contact"</span><span style="color:#D4D4D4">:  {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">5</span><span style="color:#D4D4D4">,   </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">3600</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#D4D4D4">        }</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> process_request</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        exempt = [</span><span style="color:#CE9178">"/static/"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/media/"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/favicon.ico"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/admin/"</span><span style="color:#D4D4D4">]</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#DCDCAA"> any</span><span style="color:#D4D4D4">(request.path.startswith(p) </span><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> p </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> exempt):</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#569CD6"> None</span></span>
<span class="line"><span style="color:#D4D4D4">        ip = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">._get_client_ip(request)</span></span>
<span class="line"><span style="color:#D4D4D4">        endpoint = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">._get_endpoint_type(request.path)</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#569CD6"> not</span><span style="color:#569CD6"> self</span><span style="color:#D4D4D4">._check_rate_limit(ip, endpoint):</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#D4D4D4"> HttpResponse(</span></span>
<span class="line"><span style="color:#D4D4D4">                json.dumps({</span><span style="color:#CE9178">"detail"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"Rate limit exceeded."</span><span style="color:#D4D4D4">}),</span></span>
<span class="line"><span style="color:#9CDCFE">                content_type</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"application/json"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#9CDCFE">                status</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">429</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">            )</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#569CD6"> None</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _get_client_ip</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#CE9178">        """リバースプロキシ経由の実クライアントIPを取得する"""</span></span>
<span class="line"><span style="color:#D4D4D4">        remote_addr = request.META.get(</span><span style="color:#CE9178">"REMOTE_ADDR"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">""</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">        trusted = </span><span style="color:#DCDCAA">getattr</span><span style="color:#D4D4D4">(settings, </span><span style="color:#CE9178">"TRUSTED_PROXIES"</span><span style="color:#D4D4D4">, [])</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#D4D4D4"> remote_addr </span><span style="color:#569CD6">in</span><span style="color:#D4D4D4"> trusted:</span></span>
<span class="line"><span style="color:#D4D4D4">            xff = request.META.get(</span><span style="color:#CE9178">"HTTP_X_FORWARDED_FOR"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">""</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#C586C0">            if</span><span style="color:#D4D4D4"> xff:</span></span>
<span class="line"><span style="color:#6A9955">                # nginx は実クライアントIPを末尾に追記する</span></span>
<span class="line"><span style="color:#C586C0">                return</span><span style="color:#D4D4D4"> xff.split(</span><span style="color:#CE9178">","</span><span style="color:#D4D4D4">)[-</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">].strip()</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> remote_addr</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _get_endpoint_type</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">path</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/api/auth/register/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "register"</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/auth/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path </span><span style="color:#569CD6">or</span><span style="color:#CE9178"> "/login"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "auth"</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/api/contact/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "contact"</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#CE9178"> "default"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _check_rate_limit</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">ip</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">endpoint</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#CE9178">        """アトミックなカウントアップで競合を防ぐ"""</span></span>
<span class="line"><span style="color:#D4D4D4">        config = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.rate_limits.get(endpoint, </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.rate_limits[</span><span style="color:#CE9178">"default"</span><span style="color:#D4D4D4">])</span></span>
<span class="line"><span style="color:#D4D4D4">        key = </span><span style="color:#569CD6">f</span><span style="color:#CE9178">"rate_limit:</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">endpoint</span><span style="color:#569CD6">}</span><span style="color:#CE9178">:</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">ip</span><span style="color:#569CD6">}</span><span style="color:#CE9178">"</span></span>
<span class="line"><span style="color:#6A9955">        # キーが存在しない場合のみ0で初期化（TTL付き）</span></span>
<span class="line"><span style="color:#D4D4D4">        cache.add(key, </span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">, config[</span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">])</span></span>
<span class="line"><span style="color:#6A9955">        # アトミックにインクリメント</span></span>
<span class="line"><span style="color:#D4D4D4">        count = cache.incr(key)</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> count &lt;= config[</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">ポイントは <code>cache.add()</code> と <code>cache.incr()</code> の組み合わせです。<code>cache.add()</code> はキーが存在しない場合のみ値をセットし、TTLも同時に設定します。その後 <code>cache.incr()</code> でアトミックにカウントを増やします。</p>



<p class="wp-block-paragraph">もし <code>cache.get()</code> → <code>cache.set()</code> のパターンで書いてしまうと、並走リクエストが同時に「0件」を読んでそれぞれがカウントをリセットするレースコンディションが起きます。</p>



<h2 class="wp-block-heading">URL の設定</h2>



<p class="wp-block-paragraph">DjoserのURLを2行追加します。<code>djoser.urls</code> がユーザー管理系エンドポイント、<code>djoser.urls.jwt</code> がJWT発行・リフレッシュ・ログアウトのエンドポイントを提供します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path, include

urlpatterns = [
    path("auth/", include("djoser.urls")),
    path("auth/", include("djoser.urls.jwt")),
    path("api/", include("apps.main.urls")),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path, include</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"auth/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"djoser.urls"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"auth/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"djoser.urls.jwt"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"api/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"apps.main.urls"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">この設定で有効になる主なエンドポイントです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>POST /auth/jwt/create/</strong><br>ログイン。アクセストークンとリフレッシュトークンを返す。</li>

<li><strong>POST /auth/jwt/refresh/</strong><br>リフレッシュ。HttpOnly CookieのリフレッシュトークンをもとにアクセストークンをJSON で返す。</li>

<li><strong>POST /auth/logout/</strong><br>ログアウト。リフレッシュトークンをブラックリストに登録する。</li>

<li><strong>GET /auth/users/me/</strong><br>ログイン中のユーザー情報を返す。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">バックエンドの設定はこれで完成です。フロントエンド側でこれらのエンドポイントをどう呼び出すかは、次の記事で解説します。</p>


<div class="swell-block-postLink"></div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</title>
		<link>https://cfxlog.com/nextjs-django-jwt-auth-design/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 13 May 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[Next.js]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nextjs-django-jwt-auth-design/</guid>

					<description><![CDATA[JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。 この記事では、なぜその設計になるのかを理由から解説します。 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>JWTをlocalStorageに保存していいのか不安</li>

<li>アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい</li>

<li>XSSとCSRFを両方対策した設計の考え方を理解したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。</p>



<p class="wp-block-paragraph">この記事では、なぜその設計になるのかを理由から解説します。実装コードはバックエンド・フロントエンドで別記事に分けてあるので、この記事では「設計の考え方」に絞ります。</p>



<h2 class="wp-block-heading">JWTの保存場所は3種類ある</h2>



<p class="wp-block-paragraph">JWTを保存できる場所は主に3つあり、それぞれセキュリティ特性が異なります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>localStorage</strong><br>JavaScriptから自由に読み書きできる。XSSが成立すると <code>localStorage.getItem()</code> 一行でトークンが盗まれる。</li>

<li><strong>HttpOnly Cookie</strong><br>JavaScriptから読み書きできない。ただしブラウザが同一オリジンへのリクエストに自動付与するため、CSRF攻撃の対象になりやすい。</li>

<li><strong>メモリ（JS変数）</strong><br>ページをまたいで持続しない。同じタブ内のJavaScriptからは参照できるが、localStorageのように永続化されないため露出範囲が限られる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">「HttpOnly Cookieが最も安全だから、全部そこに入れればいい」と思いたくなります。しかし、アクセストークンとリフレッシュトークンでは性質が大きく違うため、同じ保存先にまとめるのは最適解ではありません。</p>



<h2 class="wp-block-heading">アクセストークンとリフレッシュトークンを分ける理由</h2>



<p class="wp-block-paragraph">2種類のトークンには、用途と有効期限に大きな差があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン（有効期限: 15分）</strong><br>APIリクエストのたびに <code>Authorization: Bearer</code> ヘッダーに付けて送る。短命なので仮に流出しても被害期間が限定される。</li>

<li><strong>リフレッシュトークン（有効期限: 14日）</strong><br>アクセストークンが切れたときだけ使う。長命なので慎重に管理する必要がある。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この性質の差から、次の方針が導き出されます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン → メモリ（JS変数）</strong><br>短命なのでリロードで消えても問題ない。Authorizationヘッダーで送るため、Cookieのような自動付与によるCSRFリスクがない。</li>

<li><strong>リフレッシュトークン → HttpOnly Cookie（パス: /auth/ に限定）</strong><br>JavaScriptから読めないのでXSSで盗まれない。パスを <code>/auth/</code> に絞ることで <code>/api/</code> へのリクエストにはCookieが付かず、CSRF攻撃の対象面を最小化できる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">両方をHttpOnly Cookieに入れた場合と比べて、アクセストークンがヘッダー送信のみになるため、CSRFトークンによる保護が不要なリクエストの範囲が広がります。</p>



<h2 class="wp-block-heading">認証フローの全体像</h2>



<p class="wp-block-paragraph">設計を決めたら、次はフローを整理します。ログインからAPIアクセス、トークン更新、ログアウトまでの流れです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list">
<li><strong>ページ初期化</strong><br>CSRF Cookieを取得 → <code>/auth/jwt/refresh/</code> にリクエスト → ブラウザがHttpOnly Cookieを自動送信 → サーバーがアクセストークンを返す → メモリに保存する</li>

<li><strong>APIリクエスト</strong><br>メモリ上のアクセストークンを <code>Authorization: Bearer {token}</code> ヘッダーに付けて送信する</li>

<li><strong>401レスポンス時</strong><br>アクセストークンの有効期限切れ → <code>refreshToken()</code> でトークン更新 → 新しいアクセストークンをメモリに保存 → 元のリクエストを自動リトライする</li>

<li><strong>ログアウト</strong><br>サーバー側でリフレッシュトークンをブラックリスト登録 → メモリ上のアクセストークンをクリアする</li>
</ol>
</div></div>



<p class="wp-block-paragraph">「メモリ保存だとページリロードでトークンが消えるのでは？」という疑問は正しくて、リロード後はステップ1の初期化フローが走ります。有効なリフレッシュCookieがあれば自動でアクセストークンが復元されます。</p>



<h2 class="wp-block-heading">ROTATE_REFRESH_TOKENSが引き起こす並走リフレッシュ問題</h2>



<p class="wp-block-paragraph">Djangoの <code>djangorestframework-simplejwt</code> では <code>ROTATE_REFRESH_TOKENS = True</code> を設定すると、リフレッシュのたびに新しいリフレッシュトークンが発行され、古いトークンがブラックリストに登録されます。セキュリティ上望ましい設定ですが、フロントエンドで問題が起きることがあります。</p>



<p class="wp-block-paragraph">ページ読み込み直後など、複数のAPIリクエストが同時に走るタイミングで、それぞれが並走して <code>refreshToken()</code> を呼び出すケースです。1本目のリフレッシュが成功すると古いリフレッシュトークンがブラックリストに入り、2本目以降は同じトークンで呼び出しているためエラーになります。</p>



<p class="wp-block-paragraph">対策は、進行中のリフレッシュリクエストがあれば新たに呼び出さず、同じPromiseを使い回す「mutex」パターンです。シンプルな実装で解決できます。詳しくはフロントエンド実装の記事で解説します。</p>



<h2 class="wp-block-heading">バックエンド（Django）の実装</h2>



<p class="wp-block-paragraph">SimpleJWT・Djoserの設定と、RedisキャッシュによるレートリミットミドルウェアをDjangoで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-simplejwt-djoser-setup/">Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</a>
						<span class="p-blogCard__excerpt">DjangoでJWT認証を実装したい SimpleJWTとDjoserをどう組み合わせるか知りたい 不要なエンドポイントを封鎖してセキュリティを高めたい この記事は、Next.js + Django J&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">フロントエンド（Next.js）の実装</h2>



<p class="wp-block-paragraph">アクセストークンのメモリ管理・セッションフラグ・refreshToken()のmutex・apiFetch()の自動リトライをTypeScriptで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-jwt-memory-token-auth/">Next.js JWT認証の実装｜アクセストークンをメモリ管理・リフレッシュ並走バグを防ぐmutexパターン</a>
						<span class="p-blogCard__excerpt">Next.jsでJWTトークンをどこに保存すればいいか知りたい 複数リクエストが同時にリフレッシュを呼んでエラーになる問題を解決したい 401レスポンスを受け取ったときに自&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Python】requests ライブラリの使い方【Web API アクセス】</title>
		<link>https://cfxlog.com/python-requests-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 09 Mar 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[API連携]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4992</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-requests-guide.jpg" class="webfeedsFeaturedVisual" /></p>requests ライブラリの役割は、HTTP リクエストを行うことです。 つまり Python を使って Web 上から自由に情報取得できるようになるので、プログラムに実装できる機能の幅が一気に広がります。 本記事では [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-requests-guide.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Web API から情報取得したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">requests ライブラリの役割は、HTTP リクエストを行うことです。</p>



<p class="wp-block-paragraph">つまり Python を使って Web 上から自由に情報取得できるようになるので、プログラムに実装できる機能の幅が一気に広がります。</p>



<p class="wp-block-paragraph">本記事では、難易度の低い「Web API へのアクセス方法」を解説します。</p>



<p class="wp-block-paragraph">後日 Beautiful Soup を併用した「スクレイピングの方法」を別記事にしようと思っていますので、記事が完成しましたらこちらでご案内する予定です。</p>



<p class="wp-block-paragraph">なお、requests ライブラリをさらに深く理解するためには HTTP 通信の理解が必須です。HTTP の理解に不安がある方には、『<a href="https://amzn.to/3Sbvu6x">Real World HTTP</a>』の通読を強くおすすめします。</p>



<h2 class="wp-block-heading">requests ライブラリのざっくりした説明</h2>



<h3 class="wp-block-heading">requests ライブラリの役割</h3>



<p class="wp-block-paragraph">Python を使って HTTP 通信するためのライブラリです。</p>



<p class="wp-block-paragraph">つまり自分の手元にある PC と遠隔地にあるサーバーとの間で、HTTP というルールに従って情報を送信したり受信したりできるものになります。</p>



<p class="wp-block-paragraph">ライブラリ名は、<strong>サーバーに情報を要求する = &#8220;requests&#8221; </strong>と考えるとわかりやすいかもしれません。</p>



<p class="wp-block-paragraph">直感的な理解のために、具体例をあげてみます。</p>



<p class="wp-block-paragraph">普段 Chrome などのブラウザのアドレスバーに「http://~」などと打ち込むことがあると思いますが、その時には裏側で以下のことが行われています。/</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>URLを入力してEnterを押す</li>



<li>サーバーにページの内容をリクエストする</li>



<li>ページの内容が自分のPCに返ってくる</li>



<li>ブラウザが画面を表示する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この「ページの内容を要求（リクエスト）する」ことと、「ページの内容が返却（レスポンス）される」部分にHTTP通信が利用されているというわけです。</p>



<h3 class="wp-block-heading">urllib ライブラリとの違い</h3>



<p class="wp-block-paragraph">Python には urllib という標準モジュールがあります。<br>実は、この urllib.request を使っても HTTP 通信を行うことは可能です。</p>



<p class="wp-block-paragraph">ただし、特別な理由がない限り requests ライブラリを推奨します。</p>



<p class="wp-block-paragraph">requests ライブラリは urllib をより使いやすくカスタマイズしたものであり、同じことをするにしても urllib.request を使うと相当コード量が増えてしまうからです。</p>



<h2 class="wp-block-heading">requests を使った Web API へのアクセス方法</h2>



<p class="wp-block-paragraph">Web APIへのアクセスは、以下の流れで行います。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>利用する Web API の調査</li>



<li>ライブラリのインストール</li>



<li>コードを作成・実行する</li>
</ol>
</div></div>



<p class="wp-block-paragraph">今回は、例として「<a href="https://weather.tsukumijima.net/">天気予報 API（livedoor 天気互換）</a>」を活用してみます。</p>



<p class="wp-block-paragraph">気象庁から配信されている日本全国の天気予報を取得できます。</p>



<h3 class="wp-block-heading">利用する Web API の調査</h3>



<p class="wp-block-paragraph">最初の段階で、以下の内容は調査しておくと良いです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>API の利用規約を精読する
<ul class="wp-block-list">
<li>利用料金</li>



<li>リクエストの制限回数</li>



<li>許可されている利用目的</li>
</ul>
</li>



<li>アクセス先のURL（エンドポイント）を調べる</li>



<li>認証系で必要な情報を確認する</li>
</ul>
</div></div>



<h4 class="wp-block-heading">API の利用規約を精読する</h4>



<p class="wp-block-paragraph">利用規約には API を使うためのお約束ごとです。必ず確認するようにしてください。</p>



<p class="wp-block-paragraph">まず、有料・無料を確認します。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">サービスの利用は無料ですが、この API を利用したことで何らかの不具合が発生しても責任は負えません。自己責任にてお願いします。</p>
<cite><a href="https://weather.tsukumijima.net/">天気予報 API（livedoor 天気互換）</a></cite></blockquote>



<p class="wp-block-paragraph">そして必ず確認したいのが、<strong>リクエストのレート制限について</strong>です。</p>



<p class="wp-block-paragraph">過度に Web API に対してリクエストを送ってしまうとサーバーに大きな負担をかけてしまい、最悪の場合はサーバーがダウンしてしまいます。</p>



<p class="wp-block-paragraph">そのようなことがないよう、通常は API の利用規約内に「リクエストは〇〇秒以上の間隔をあけてアクセスするように」などの決まりが書かれています。</p>



<p class="wp-block-paragraph">今回の天気予報 API では、以下の記述がありました。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">あまり強いサーバーではないので、API に連続してアクセスする場合は<strong>最低でも 0.5 秒以上間隔を空けてから行ってください</strong>。</p>
<cite><a href="https://weather.tsukumijima.net/">天気予報 API（livedoor 天気互換）</a></cite></blockquote>



<p class="wp-block-paragraph">仮に書かれていなかった場合には、API 提供者に確認をとってみるのも良いでしょう。</p>



<p class="wp-block-paragraph">また商用利用する場合には、商用 OK かどうかもチェックしてください。</p>



<p class="is-style-icon_info wp-block-paragraph">かなり大事なステップです。<br>利用規約の読み込みは丁寧に行ない、不明点を潰した状態で次のステップに進んでください。</p>



<h4 class="wp-block-heading">アクセス先のURL（エンドポイント）を調べる</h4>



<p class="wp-block-paragraph">続いて、アクセス先の URL を確認します。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">JSON データをリクエストする際のベースとなる URL は以下になります。<br><strong>https://weather.tsukumijima.net/api/forecast</strong><br>この URL に下の表のパラメータを加え、実際にリクエストします。</p>
<cite><a href="https://weather.tsukumijima.net/">天気予報 API（livedoor 天気互換）</a></cite></blockquote>



<p class="wp-block-paragraph">上記をベースに、city パラメータを加えてリクエストする仕様のようです。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">地域別に定義された ID 番号を表します。<br>リクエストする地域と ID の対応は、livedoor 天気で使われていた&nbsp;<a href="https://weather.tsukumijima.net/primary_area.xml" target="_blank" rel="noreferrer noopener">全国の地点定義表</a>&nbsp;内で「一次細分区域（cityタグ）」の ID をご参照ください。（例・佐賀県 伊万里 = 410020 ）</p>
<cite><a href="https://weather.tsukumijima.net/">天気予報 API（livedoor 天気互換）</a></cite></blockquote>



<p class="wp-block-paragraph">久留米市の天気を取得する場合は以下とするようです。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph">下記 URL にアクセスして JSON データを取得します。<br>基本 URL + 久留米の ID (400040)<br><a href="https://weather.tsukumijima.net/api/forecast/city/400040" target="_blank" rel="noreferrer noopener">https://weather.tsukumijima.net/api/forecast/city/400040</a></p>



<p class="wp-block-paragraph">クエリで取得することもできます。<br><a href="https://weather.tsukumijima.net/api/forecast?city=400040" target="_blank" rel="noreferrer noopener">https://weather.tsukumijima.net/api/forecast?city=400040</a></p>
<cite><a href="https://weather.tsukumijima.net/">天気予報 API（livedoor 天気互換）</a></cite></blockquote>



<p class="wp-block-paragraph">今回はエンドポイントが一つでしたが、APIによっては複数のエンドポイントが用意されていることの方が多いです。</p>



<p class="wp-block-paragraph">欲しい情報にアクセスできるエンドポイントを見つけ出してください。</p>



<h4 class="wp-block-heading">認証系で必要な情報を確認する</h4>



<p class="wp-block-paragraph">API によっては、以下のような追加の認証情報が必要になることがあります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>API Key</li>



<li>Access Token</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これらは利用者を識別するためのものです。</p>



<p class="wp-block-paragraph">必要な場合に requests ライブラリでリクエストを送る際に、これらの認証情報を添付することになります。</p>



<p class="wp-block-paragraph">ちなみに今回利用する「天気予報 API」では認証情報は要求されないようでした。</p>



<h3 class="wp-block-heading">ライブラリのインストール</h3>



<p class="wp-block-paragraph">ライブラリ名は<code>requests</code>です。</p>



<p class="wp-block-paragraph">以下のコマンドを実行してインストールを行いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install requests</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requests</span></span></code></pre></div>



<h3 class="wp-block-heading">コードを作成・実行する</h3>



<p class="wp-block-paragraph">最後にコードを作成します。</p>



<p class="wp-block-paragraph">今回の「天気予報API」ではクエリパラメータとして場所に関する情報を渡す必要があるので、以下のように params をリクエストに含めました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import requests

endpoint = "https://weather.tsukumijima.net/api/forecast"

params = {
    "city": 400040,
}

response = requests.get(endpoint, params=params)

# 結果を表示
print(response.text)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> requests</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">endpoint = </span><span style="color: #CE9178">&quot;https://weather.tsukumijima.net/api/forecast&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">params = {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;city&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">400040</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">response = requests.get(endpoint, </span><span style="color: #9CDCFE">params</span><span style="color: #D4D4D4">=params)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 結果を表示</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(response.text)</span></span></code></pre></div>



<p class="wp-block-paragraph">すると print(response.txt) の部分が実行され、以下が表示されるはずです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>{
  "publicTime": "2024-01-27T11:00:00+09:00",
  "publicTimeFormatted": "2024/01/27 11:00:00",
  "publishingOffice": "福岡管区気象台",
  "title": "福岡県 久留米 の天気",
  "link": "https://www.jma.go.jp/bosai/forecast/#area_type=offices&amp;area_code=400000",
  "description": {
    "publicTime": "2024-01-27T10:39:00+09:00",
    "publicTimeFormatted": "2024/01/27 10:39:00",
    "headlineText": "",
    "bodyText": "　福岡県は、高気圧に覆われて晴れの所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなっています。\n\n　２７日は、高気圧に覆われて晴れる所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなるでしょう。\n\n　２８日は、気圧の谷や寒気の影響により曇りで、雨や雪となり雷を伴う所がありますが、高気圧に覆われて次第に晴れとなるでしょう。\n\n＜天気変化等の留意点＞\n　２７日１２時から２８日１２時までに予想される１時間降水量は、多い所で、筑後地方で５ミリ、２７日１２時から２８日１２時までに予想される２４時間降水量は、多い所で、筑後地方で１０ミリの見込みです。",
    "text": "　福岡県は、高気圧に覆われて晴れの所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなっています。\n\n　２７日は、高気圧に覆われて晴れる所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなるでしょう。\n\n　２８日は、気圧の谷や寒気の影響により曇りで、雨や雪となり雷を伴う所がありますが、高気圧に覆われて次第に晴れとなるでしょう。\n\n＜天気変化等の留意点＞\n　２７日１２時から２８日１２時までに予想される１時間降水量は、多い所で、筑後地方で５ミリ、２７日１２時から２８日１２時までに予想される２４時間降水量は、多い所で、筑後地方で１０ミリの見込みです。"
  },
  "forecasts": [
    {
      "date": "2024-01-27",
      "dateLabel": "今日",
      "telop": "晴時々曇",
    ・・・
// 以下、省略</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">{</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #CE9178">&quot;publicTime&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;2024-01-27T11:00:00+09:00&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #CE9178">&quot;publicTimeFormatted&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;2024/01/27 11:00:00&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #CE9178">&quot;publishingOffice&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;福岡管区気象台&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #CE9178">&quot;title&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;福岡県 久留米 の天気&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #CE9178">&quot;link&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;https://www.jma.go.jp/bosai/forecast/#area_type=offices&amp;area_code=400000&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #CE9178">&quot;description&quot;</span><span style="color: #D4D4D4">: {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;publicTime&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;2024-01-27T10:39:00+09:00&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;publicTimeFormatted&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;2024/01/27 10:39:00&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;headlineText&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;bodyText&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;　福岡県は、高気圧に覆われて晴れの所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなっています。</span><span style="color: #D7BA7D">\n\n</span><span style="color: #CE9178">　２７日は、高気圧に覆われて晴れる所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなるでしょう。</span><span style="color: #D7BA7D">\n\n</span><span style="color: #CE9178">　２８日は、気圧の谷や寒気の影響により曇りで、雨や雪となり雷を伴う所がありますが、高気圧に覆われて次第に晴れとなるでしょう。</span><span style="color: #D7BA7D">\n\n</span><span style="color: #CE9178">＜天気変化等の留意点＞</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">　２７日１２時から２８日１２時までに予想される１時間降水量は、多い所で、筑後地方で５ミリ、２７日１２時から２８日１２時までに予想される２４時間降水量は、多い所で、筑後地方で１０ミリの見込みです。&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;text&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;　福岡県は、高気圧に覆われて晴れの所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなっています。</span><span style="color: #D7BA7D">\n\n</span><span style="color: #CE9178">　２７日は、高気圧に覆われて晴れる所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなるでしょう。</span><span style="color: #D7BA7D">\n\n</span><span style="color: #CE9178">　２８日は、気圧の谷や寒気の影響により曇りで、雨や雪となり雷を伴う所がありますが、高気圧に覆われて次第に晴れとなるでしょう。</span><span style="color: #D7BA7D">\n\n</span><span style="color: #CE9178">＜天気変化等の留意点＞</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">　２７日１２時から２８日１２時までに予想される１時間降水量は、多い所で、筑後地方で５ミリ、２７日１２時から２８日１２時までに予想される２４時間降水量は、多い所で、筑後地方で１０ミリの見込みです。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">  },</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #CE9178">&quot;forecasts&quot;</span><span style="color: #D4D4D4">: [</span></span>
<span class="line"><span style="color: #D4D4D4">    {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;date&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;2024-01-27&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;dateLabel&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;今日&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;telop&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;晴時々曇&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    ・・・</span></span>
<span class="line"><span style="color: #D4D4D4">// 以下、省略</span></span></code></pre></div>



<h2 class="wp-block-heading">実装のために知っておくと便利な知識</h2>



<h3 class="wp-block-heading">レスポンスのうち、要素の一部を取得する</h3>



<p class="wp-block-paragraph">上記で response として受け取ったデータは、Response オブジェクトです。</p>



<p class="wp-block-paragraph">これではちょっと扱いづらいので、以下の流れで辞書にしてから要素を取り出すことが多いと思います。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Response オブジェクトを辞書に変換する</li>



<li>辞書として要素にアクセスする</li>
</ul>
</div></div>



<p class="wp-block-paragraph">先ほどのレスポンスを例に、title の値を取得するコード例を示します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import requests

endpoint = "https://weather.tsukumijima.net/api/forecast"

params = {
    "city": 400040,
}

response = requests.get(endpoint, params=params)

# json() メソッドで辞書に変換する
response_dict = response.json()
title = response_dict&#91;"title"&#93;

print(title) </textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> requests</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">endpoint = </span><span style="color: #CE9178">&quot;https://weather.tsukumijima.net/api/forecast&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">params = {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;city&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">400040</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">response = requests.get(endpoint, </span><span style="color: #9CDCFE">params</span><span style="color: #D4D4D4">=params)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># json() メソッドで辞書に変換する</span></span>
<span class="line"><span style="color: #D4D4D4">response_dict = response.json()</span></span>
<span class="line"><span style="color: #D4D4D4">title = response_dict&#91;</span><span style="color: #CE9178">&quot;title&quot;</span><span style="color: #D4D4D4">&#93;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(title) </span></span></code></pre></div>



<p class="wp-block-paragraph">すると、title に対応する値のみが出力されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>福岡県 久留米 の天気</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">福岡県 久留米 の天気</span></span></code></pre></div>



<p class="wp-block-paragraph">例えば bodyText などのより深い階層にある要素も、一般的な辞書の操作方法で取り出せます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import requests

endpoint = "https://weather.tsukumijima.net/api/forecast"

params = {
    "city": 400040,
}

response = requests.get(endpoint, params=params)

# json() メソッドで辞書に変換する
response_dict = response.json()
# bodyText を取得する
body_text = response_dict&#91;"description"&#93;&#91;"bodyText"&#93;

print(body_text) </textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> requests</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">endpoint = </span><span style="color: #CE9178">&quot;https://weather.tsukumijima.net/api/forecast&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">params = {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;city&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">400040</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">response = requests.get(endpoint, </span><span style="color: #9CDCFE">params</span><span style="color: #D4D4D4">=params)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># json() メソッドで辞書に変換する</span></span>
<span class="line"><span style="color: #D4D4D4">response_dict = response.json()</span></span>
<span class="line"><span style="color: #6A9955"># bodyText を取得する</span></span>
<span class="line"><span style="color: #D4D4D4">body_text = response_dict&#91;</span><span style="color: #CE9178">&quot;description&quot;</span><span style="color: #D4D4D4">&#93;&#91;</span><span style="color: #CE9178">&quot;bodyText&quot;</span><span style="color: #D4D4D4">&#93;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(body_text) </span></span></code></pre></div>



<p class="wp-block-paragraph">実行結果は以下になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>　福岡県は、高気圧に覆われて晴れの所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなっています。

　２７日は、高気圧に覆われて晴れる所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなるでしょう。

　２８日は、気圧の谷や寒気の影響により曇りで、雨や雪となり雷を伴う所がありますが、高気圧に覆われて次第に晴れとなるでしょう。

＜天気変化等の留意点＞
　２７日１２時から２８日１２時までに予想される１時間降水量は、多い所で、筑後地方で５ミリ、２７日１２時から２８日１２時までに予想される２４時間降水量は、多い所で、筑後地方で１０ミリの見込みです。</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">　福岡県は、高気圧に覆われて晴れの所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなっています。</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">　２７日は、高気圧に覆われて晴れる所もありますが、気圧の谷や寒気の影響により、おおむね曇りとなるでしょう。</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">　２８日は、気圧の谷や寒気の影響により曇りで、雨や雪となり雷を伴う所がありますが、高気圧に覆われて次第に晴れとなるでしょう。</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">＜天気変化等の留意点＞</span></span>
<span class="line"><span style="color: #D4D4D4">　２７日１２時から２８日１２時までに予想される１時間降水量は、多い所で、筑後地方で５ミリ、２７日１２時から２８日１２時までに予想される２４時間降水量は、多い所で、筑後地方で１０ミリの見込みです。</span></span></code></pre></div>



<h3 class="wp-block-heading">GET 以外の HTTP メソッドを使ってアクセスする方法</h3>



<p class="wp-block-paragraph">先ほどは<code>requests.get()</code>としてリクエストを送りました。</p>



<p class="wp-block-paragraph">これはサーバーに対して「GET メソッドでリクエストを送る」という指示になるのですが、HTTP メソッドには他にもいくつか種類が存在します。</p>



<figure class="wp-block-table"><table><thead><tr><th>HTTPメソッド</th><th>requests のメソッド</th></tr></thead><tbody><tr><td>GET</td><td>get()</td></tr><tr><td>POST</td><td>post()</td></tr><tr><td>PUT</td><td>put()</td></tr><tr><td>DELETE</td><td>delete()</td></tr><tr><td>HEAD</td><td>head()</td></tr><tr><td>OPTIONS</td><td>options()</td></tr><tr><td>PATCH</td><td>patch()</td></tr></tbody></table><figcaption class="wp-element-caption">HTTPメソッドとrequestsメソッドの対応関係</figcaption></figure>



<p class="wp-block-paragraph">Web API では、GET または POST を使うことが多いと思います。</p>



<p class="wp-block-paragraph">別のメソッドが指定されている場合にも、HTTP メソッドと完全に対応する形で requests のメソッドも用意されているのであまり混乱することはないと思います。</p>



<h3 class="wp-block-heading">リクエスト時に同時に送信できる情報</h3>



<p class="wp-block-paragraph">エンドポイントにアクセスする際に、特定の情報を添付することができます。</p>



<p class="wp-block-paragraph">添付方法には次のような種類があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>クエリパラメータ</li>



<li>リクエストボディ</li>



<li>フォームデータ</li>



<li>HTTP ヘッダー</li>
</ul>
</div></div>



<p class="wp-block-paragraph">どの方法でデータを添付するかについては、API ドキュメントなどに書いてあります。</p>



<p class="wp-block-paragraph">ここではそれぞれ requests ライブラリでどのように情報を送信するかをサクッと解説します。</p>



<h4 class="wp-block-heading">クエリパラメータ</h4>



<p class="wp-block-paragraph">クエリパラメータをつける場合は、params 引数に辞書を渡します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># クエリパラメータを定義
params = {
    "city": 400040,
}

response = requests.get(endpoint, params=params)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># クエリパラメータを定義</span></span>
<span class="line"><span style="color: #D4D4D4">params = {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;city&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">400040</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">response = requests.get(endpoint, </span><span style="color: #9CDCFE">params</span><span style="color: #D4D4D4">=params)</span></span></code></pre></div>



<p class="wp-block-paragraph">先ほどの天気予報APIでも、クエリパラメータを使ってリクエストを送りました。</p>



<h4 class="wp-block-heading">リクエストボディ</h4>



<p class="wp-block-paragraph">リクエストボディは、json 引数に辞書を渡します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># リクエストボディを定義
request_body = {
    "key": "value",
}

response = requests.get(endpoint, json=request_body)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># リクエストボディを定義</span></span>
<span class="line"><span style="color: #D4D4D4">request_body = {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;key&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;value&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">response = requests.get(endpoint, </span><span style="color: #9CDCFE">json</span><span style="color: #D4D4D4">=request_body)</span></span></code></pre></div>



<h4 class="wp-block-heading">フォームデータ</h4>



<p class="wp-block-paragraph">ファイルアップロードやフォーム送信には、フォームデータが使われることがあります。</p>



<p class="wp-block-paragraph">data 引数に辞書を渡してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># フォームデータを定義
form_data = {
    "key": "value",
}

response = requests.get(endpoint, data=form_data)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># フォームデータを定義</span></span>
<span class="line"><span style="color: #D4D4D4">form_data = {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;key&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;value&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">response = requests.get(endpoint, </span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">=form_data)</span></span></code></pre></div>



<h4 class="wp-block-heading">HTTP ヘッダー</h4>



<p class="wp-block-paragraph">HTTP ヘッダーに値を含める場合には、headers 引数に辞書を渡します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># HTTP ヘッダーを定義
headers = {
    "Authorization": "Bearer YOUR_TOKEN"
}

response = requests.get(endpoint, headers=headers)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># HTTP ヘッダーを定義</span></span>
<span class="line"><span style="color: #D4D4D4">headers = {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;Authorization&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;Bearer YOUR_TOKEN&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">response = requests.get(endpoint, </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">=headers)</span></span></code></pre></div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【FastAPI】API ルーティングの設計について徹底解説！</title>
		<link>https://cfxlog.com/python-fastapi-routing/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 08 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[FastAPI]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[Webアプリ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4636</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-fastapi-routing.jpg" class="webfeedsFeaturedVisual" /></p>このような疑問にお答えします。 FastAPI では関数を使ってルーティングを表現するので、端的で読みやすいです。 本記事ではルーティングにまつわる以下のような内容を解説します。 FastAPIを初めて触る方でも理解しや [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-fastapi-routing.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>FastAPI のルーティングの方法が知りたい</li>



<li>バリデーションってどうやるの？</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">FastAPI では関数を使ってルーティングを表現するので、端的で読みやすいです。</p>



<p class="wp-block-paragraph">本記事ではルーティングにまつわる以下のような内容を解説します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>各パラメータの見分け方</li>



<li>エンドポイントの作成方法</li>



<li>パスパラメータを扱う方法</li>



<li>リクエストボディを扱う方法</li>



<li>エンドポイントの柔軟性を高める設計のヒント</li>
</ul>
</div></div>



<p class="wp-block-paragraph">FastAPIを初めて触る方でも理解しやすいよう、できるだけ平易に解説していきます。</p>



<h2 class="wp-block-heading">FastAPI での各パラメータの見分け方</h2>



<p class="wp-block-paragraph">パラメータには以下の種類があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>パスパラメータ</li>



<li>クエリパラメータ</li>



<li>リクエストボディ</li>
</ul>
</div></div>



<p class="wp-block-paragraph">FastAPI のコードは一見するとこれらの違いが分かりにくいので、ここで見分け方を解説します。</p>



<h3 class="wp-block-heading">パスパラメータ</h3>



<p class="wp-block-paragraph">パスパラメータは、URLのパスの一部として表現されます。</p>



<p class="wp-block-paragraph">つまり<strong>URL 定義をしている部分のうち、波括弧（<code>{}</code>）の中身</strong>がパスパラメータです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@app.get("/users/{user_id}")
async def get_user(user_id: int):
    return {"user_id": user_id}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/users/</span><span style="color: #569CD6">{user_id}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">get_user</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">user_id</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;user_id&quot;</span><span style="color: #D4D4D4">: user_id}</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の例では、<code>user_id</code>がパスパラメータになります。</p>



<p class="wp-block-paragraph">このパスパラメータを関数内で扱うため、「デコレータの波括弧内で宣言した変数名」と同じものを関数の引数として指定しています。</p>



<h3 class="wp-block-heading">クエリパラメータ</h3>



<p class="wp-block-paragraph">クエリパラメータは URL の<code>?</code>の後に指定されます。<br>Key と Value の組み合わせで表現されるタイプのパラメータです。</p>



<p class="wp-block-paragraph">FastAPI では、<strong>関数の引数がデフォルト値を持つ場合</strong>にクエリパラメータと解釈します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@app.get("/items/")
async def read_items(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_items</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">skip</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">limit</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;skip&quot;</span><span style="color: #D4D4D4">: skip, </span><span style="color: #CE9178">&quot;limit&quot;</span><span style="color: #D4D4D4">: limit}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>skip</code>と<code>limit</code>はデフォルト値が設定されているので、どちらもクエリパラメータです。</p>



<p class="wp-block-paragraph">これはフィルタや設定オプションに使われることが多いです。</p>



<h3 class="wp-block-heading">リクエストボディ</h3>



<p class="wp-block-paragraph">リクエストボディは「リクエストの本体部分に含まれるデータ」で、JSON などの形式で送信されることが多いです。</p>



<p class="wp-block-paragraph">FastAPI では、<strong>Pydantic の BaseModel を継承したクラスを引数とした場合</strong>にリクエストボディと判定されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from pydantic import BaseModel

class Item(BaseModel):
    name: str
    description: str

@app.post("/items/")
async def create_item(item: Item):
    return item</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> pydantic </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BaseModel</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Item</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseModel</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    name: </span><span style="color: #4EC9B0">str</span></span>
<span class="line"><span style="color: #D4D4D4">    description: </span><span style="color: #4EC9B0">str</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.post</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">create_item</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">item</span><span style="color: #D4D4D4">: Item):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> item</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の例を見てみると、<code>item</code>という引数は BaseModel を継承した Item クラスを型に指定しています。</p>



<p class="wp-block-paragraph">そのため、<code>item</code>はリクエストボディから取得されます。</p>



<p class="is-style-icon_announce wp-block-paragraph">リクエストボディは POST, PUT メソッドで使われます。</p>



<h2 class="wp-block-heading">FastAPI におけるエンドポイントの作成方法</h2>



<h3 class="wp-block-heading">基本的なルート設定方法</h3>



<p class="wp-block-paragraph">FastAPI では「各HTTPメソッドごとに用意されているデコレータ」を使います。</p>



<p class="wp-block-paragraph">非同期通信を行うため、<code>async def</code>を使っていきます。</p>



<p class="is-style-icon_book wp-block-paragraph">パスパラメータやリクエストボディは関数の引数で指定します。</p>



<h4 class="wp-block-heading">GET リクエスト</h4>



<p class="wp-block-paragraph">GET メソッドはリソースを読み出すためのメソッドです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI


app = FastAPI()

@app.get("/items")
async def read_items():
    return {"message": "GETリクエストを受け取りました"}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_items</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;message&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;GETリクエストを受け取りました&quot;</span><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">リソースに変更を加える場合には、POST メソッド以降を利用します。</p>



<h4 class="wp-block-heading">POST リクエスト</h4>



<p class="wp-block-paragraph">新しいリソースを作成する場合に使われるのが POST メソッドです。</p>



<p class="wp-block-paragraph">以下のように記述することで、POST リクエストに含まれるリクエストボディ<code>item</code>を受け取ることができます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI


app = FastAPI()

@app.post("/items")
async def create_item(item: dict):
    return {"message": "アイテムを作成しました", "item": item}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.post</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">create_item</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">item</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">dict</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;message&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;アイテムを作成しました&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;item&quot;</span><span style="color: #D4D4D4">: item}</span></span></code></pre></div>



<p class="wp-block-paragraph">受け取ったJSON に対して、便宜的に<code>item</code>という名前をつけたと考えると理解しやすいです。</p>



<p class="wp-block-paragraph">つまり、クライアント側からは POST メソッドで以下のような JSON をリクエストボディに含めることになります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">JSON</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>{
  "name": "example item",
  "price": 1500
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">{</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;name&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;example item&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;price&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">1500</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">FastAPI 側ではこの JSON を Python の辞書オブジェクトとして解釈することになります。</p>



<p class="is-style-icon_announce wp-block-paragraph">もちろん「パスパラメータ」や「クエリパラメータ」を含めることもできます。</p>



<h4 class="wp-block-heading">PUT リクエスト</h4>



<p class="wp-block-paragraph">PUT はリソースを作成または置換するために使用されます。<br>リソースがすでにある場合は更新し、ない場合は新規作成します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI


app = FastAPI()

@app.put("/items/{item_id}")
async def update_item(item_id: int, item: dict):
    return {"message": "アイテムを更新しました", "item_id": item_id, "item": item}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.put</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/</span><span style="color: #569CD6">{item_id}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">update_item</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">item_id</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">item</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">dict</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;message&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;アイテムを更新しました&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;item_id&quot;</span><span style="color: #D4D4D4">: item_id, </span><span style="color: #CE9178">&quot;item&quot;</span><span style="color: #D4D4D4">: item}</span></span></code></pre></div>



<p class="wp-block-paragraph">上記では、「リクエストボディ」と「パスパラメータ」からデータを受け取るようになっています。</p>



<h4 class="wp-block-heading">DELETE リクエスト</h4>



<p class="wp-block-paragraph">DELETE はリソースを削除するメソッドです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI


app = FastAPI()

@app.delete("/items/{item_id}")
async def delete_item(item_id: int):
    return {"message": "アイテムを削除しました", "item_id": item_id}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.delete</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/</span><span style="color: #569CD6">{item_id}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">delete_item</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">item_id</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;message&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;アイテムを削除しました&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;item_id&quot;</span><span style="color: #D4D4D4">: item_id}</span></span></code></pre></div>



<p class="wp-block-paragraph">特定の<code>item_id</code>に対してリソースの削除をするコード例になります。</p>



<p class="is-style-icon_info wp-block-paragraph">実際にリソースの削除をするためには、関数内でレコード削除のビジネスロジック追加が必要です。</p>



<h2 class="wp-block-heading">FastAPI でパスパラメータを扱う方法</h2>



<p class="wp-block-paragraph">パスパラメータは「URL の一部に動的な値」を指定する方法になります。</p>



<p class="wp-block-paragraph">パスパラメータは渡されないと「不完全なURL」とみなされる点には注意が必要です。</p>



<h3 class="wp-block-heading" id="pathparameter-basic">パスパラメータの基本的な使い方</h3>



<p class="wp-block-paragraph">FastAPI では、「デコレータ内」と「関数の引数」でパスパラメータを定義します。</p>



<p class="wp-block-paragraph">以下はパスパラメータとして<code>item_id</code>を定義した例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI

app = FastAPI()

@app.get("/items/{item_id}")
async def read_item(item_id: int):
    return {"item_id": item_id, "description": "こちらがアイテムの説明です。"}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/</span><span style="color: #569CD6">{item_id}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_item</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">item_id</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;item_id&quot;</span><span style="color: #D4D4D4">: item_id, </span><span style="color: #CE9178">&quot;description&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;こちらがアイテムの説明です。&quot;</span><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">関数の引数に型注釈として<code>int</code>が指定されているので、FastAPI は以下のことを行います。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>item_idは整数型に変換される</li>



<li>整数型にできなければエラーを返す</li>
</ul>
</div></div>



<p class="wp-block-paragraph">例えば型注釈として<code>int</code>を指定したにも関わらず &#8220;abc&#8221; を渡した場合には、&#8221;422 Unprocessable Entity&#8221; といステータスコードを返却します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>型注釈に指定できるデータ型</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">使えるデータは幅広く、例えば次のようなものがあります。</p>



<ul class="wp-block-list">
<li>Python 標準のデータ型（str, float, list, set など）</li>



<li>Pydantic のデータ型（BaseModel, EmailStr など）</li>



<li>オプショナル型、リテラル型、ユニオン型</li>
</ul>
</div></div>



<h3 class="wp-block-heading">２つ以上のパスパラメータを扱う方法</h3>



<p class="wp-block-paragraph">複数のパスパラメータを扱う場合も、考え方は同じです。</p>



<p class="wp-block-paragraph">パスパラメータとして<code>user_id</code>と<code>item_id</code>の二つを持つ場合の例を示します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@app.get("/users/{user_id}/items/{item_id}")
async def read_user_item(user_id: int, item_id: int):
    return {"user_id": user_id, "item_id": item_id, "description": "ユーザーとアイテムの情報"}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/users/</span><span style="color: #569CD6">{user_id}</span><span style="color: #CE9178">/items/</span><span style="color: #569CD6">{item_id}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_user_item</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">user_id</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">item_id</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;user_id&quot;</span><span style="color: #D4D4D4">: user_id, </span><span style="color: #CE9178">&quot;item_id&quot;</span><span style="color: #D4D4D4">: item_id, </span><span style="color: #CE9178">&quot;description&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;ユーザーとアイテムの情報&quot;</span><span style="color: #D4D4D4">}</span></span></code></pre></div>



<h3 class="wp-block-heading">パスパラメータにスラッシュを含む場合の対策</h3>



<p class="wp-block-paragraph"><code>/folder1/file1.txt</code>というまとまりをパスパラメータとして取得したい場合を考えてみましょう。</p>



<p class="wp-block-paragraph">普通にコードを書いてしまうと「スラッシュ」が境界線と判断されるので、<code>folder1</code>と<code>file1.txt</code>が別の要素として取得されてしまいます。</p>



<p class="wp-block-paragraph">これを一つのパスパラメータとして扱うには、&#8221;path&#8221; タイプを指定します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@app.get("/files/{file_path:path}")
async def read_file(file_path: str):
    return {"file_path": file_path}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/files/</span><span style="color: #569CD6">{file_path:path}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_file</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">file_path</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">str</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;file_path&quot;</span><span style="color: #D4D4D4">: file_path}</span></span></code></pre></div>



<p class="wp-block-paragraph">こうすることで<code>file_path</code>に対して<code>/folder1/file1.txt</code>が渡されても、スラッシュで分割されずに要素を取得できることになります。</p>



<h2 class="wp-block-heading">FastAPI でクエリパラメータを扱う方法</h2>



<p class="wp-block-paragraph">FastAPIでは、関数の引数にデフォルト値を設定することで、クエリパラメータになります。</p>



<p class="wp-block-paragraph">つまり、クエリパラメータが省略された場合にはデフォルト値が使用されます。</p>



<h3 class="wp-block-heading">基本的なクエリパラメータの受け取り方</h3>



<p class="wp-block-paragraph"><code>skip</code>と<code>limit</code>には初期値を設定したので、それぞれ二つの要素ともクエリパラメータとして扱われます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI

app = FastAPI()

@app.get("/items/")
async def read_items(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_items</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">skip</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">limit</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;skip&quot;</span><span style="color: #D4D4D4">: skip, </span><span style="color: #CE9178">&quot;limit&quot;</span><span style="color: #D4D4D4">: limit}</span></span></code></pre></div>



<p class="wp-block-paragraph">クライアント側から見ると、以下のようなリクエストが送信されることを想定。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Plaintext</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>/items/?skip=20&amp;limit=10</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">/items/?skip=20&amp;limit=10</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の場合、FastAPI は &#8220;skip&#8221; には &#8220;20&#8221; を、&#8221;limit&#8221; には &#8220;10&#8221; を受け取ることになります。</p>



<h3 class="wp-block-heading">クエリパラメータをオプショナルにする</h3>



<p class="wp-block-paragraph">オプショナルにするには、初期値として<code>None</code>を指定します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@app.get("/items/")
async def read_items(skip: int = 0, limit: int = 10, tag: Optional&#91;str&#93; = None):
    items = {"skip": skip, "limit": limit}
    if tag:
        items.update({"tag": tag})
    return items</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_items</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">skip</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">limit</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">tag</span><span style="color: #D4D4D4">: Optional&#91;</span><span style="color: #4EC9B0">str</span><span style="color: #D4D4D4">&#93; = </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    items = {</span><span style="color: #CE9178">&quot;skip&quot;</span><span style="color: #D4D4D4">: skip, </span><span style="color: #CE9178">&quot;limit&quot;</span><span style="color: #D4D4D4">: limit}</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> tag:</span></span>
<span class="line"><span style="color: #D4D4D4">        items.update({</span><span style="color: #CE9178">&quot;tag&quot;</span><span style="color: #D4D4D4">: tag})</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> items</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>None</code>を書かない場合、必須のクエリパラメータとなります。</p>



<h3 class="wp-block-heading">クエリパラメータのバリデーション</h3>



<p class="wp-block-paragraph">型宣言を使用してバリデーションが可能です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@app.get("/items/")
async def read_items(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_items</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">skip</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">limit</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;skip&quot;</span><span style="color: #D4D4D4">: skip, </span><span style="color: #CE9178">&quot;limit&quot;</span><span style="color: #D4D4D4">: limit}</span></span></code></pre></div>



<p class="wp-block-paragraph">この例では、以下のバリデーションを追加しました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>skip</code>: 整数、デフォルト値は0</li>



<li><code>limit</code>: 整数、デフォルト値は10</li>
</ul>
</div></div>



<p class="wp-block-paragraph">デフォルト値とは、クエリパラメータが渡されない場合の初期値です。</p>



<h3 class="wp-block-heading">Pydantic を使ったより複雑なバリデーション</h3>



<p class="wp-block-paragraph">Pydanticの <code>Field</code> を使うことで、より複雑なバリデーションを行えます。</p>



<p class="wp-block-paragraph">以下の例は、クエリパラメータで受け取る数値に「最小値」と「最大値」を設定しています</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from pydantic import BaseModel, Field
from typing import Optional

class QueryParams(BaseModel):
    skip: int = Field(default=0, ge=0)
    limit: int = Field(default=10, ge=1, le=100)

@app.get("/items/")
async def read_items(query: QueryParams = Depends()):
    return {"skip": query.skip, "limit": query.limit}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> pydantic </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BaseModel, Field</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> typing </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Optional</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">QueryParams</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseModel</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    skip: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = Field(</span><span style="color: #9CDCFE">default</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">ge</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    limit: </span><span style="color: #4EC9B0">int</span><span style="color: #D4D4D4"> = Field(</span><span style="color: #9CDCFE">default</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">ge</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">le</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">100</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_items</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">query</span><span style="color: #D4D4D4">: QueryParams = Depends()):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;skip&quot;</span><span style="color: #D4D4D4">: query.skip, </span><span style="color: #CE9178">&quot;limit&quot;</span><span style="color: #D4D4D4">: query.limit}</span></span></code></pre></div>



<p class="wp-block-paragraph">このコードで行なっていることは以下です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>skip</code>: 0以上</li>



<li><code>limit</code>: 1以上100以下</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ちなみに、数値の比較に使われる名前は以下の意味があるそうです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>ge</code>(&gt;=): greater than or equal</li>



<li><code>gt</code>(&gt;): greater than</li>



<li><code>le</code>(&lt;=): less than or equal </li>



<li><code>lt</code>(&lt;): less than</li>
</ul>
</div></div>



<p class="wp-block-paragraph">どれがどの効果を持つか思い出す際に便利です。</p>



<h2 class="wp-block-heading">FastAPI でリクエストボディを扱う方法</h2>



<p class="wp-block-paragraph">FastAPI では、リクエストボディに対して複雑なバリデーションを行うことができます。</p>



<p class="wp-block-paragraph">Pydanticモデルを定義して「型宣言」と「バリデーションルール」を組み込むことで対応することになります。</p>



<p class="wp-block-paragraph">以下の例では<code>Item</code>というリクエストボディのバリデーションを行っています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI
from pydantic import BaseModel, Field

class Item(BaseModel):
    name: str
    description: str = None
    price: float = Field(gt=0, description="The price must be greater than zero")
    tax: float = None

app = FastAPI()

@app.post("/items/")
async def create_item(item: Item):
    return {"name": item.name, "price": item.price}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> pydantic </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BaseModel, Field</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Item</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseModel</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    name: </span><span style="color: #4EC9B0">str</span></span>
<span class="line"><span style="color: #D4D4D4">    description: </span><span style="color: #4EC9B0">str</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">None</span></span>
<span class="line"><span style="color: #D4D4D4">    price: </span><span style="color: #4EC9B0">float</span><span style="color: #D4D4D4"> = Field(</span><span style="color: #9CDCFE">gt</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">description</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;The price must be greater than zero&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    tax: </span><span style="color: #4EC9B0">float</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">None</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.post</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/items/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">create_item</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">item</span><span style="color: #D4D4D4">: Item):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;name&quot;</span><span style="color: #D4D4D4">: item.name, </span><span style="color: #CE9178">&quot;price&quot;</span><span style="color: #D4D4D4">: item.price}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>Item</code>クラス内の要素の定義は以下です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>name</code>: 必須項目</li>



<li><code>description</code>: オプショナル</li>



<li><code>price</code>: 0より大きい値</li>



<li><code>tax</code>: オプショナル</li>
</ul>
</div></div>



<p class="wp-block-paragraph">初期値ありは必須項目、初期値なしはオプショナル（任意）の項目ということになります。</p>



<p class="wp-block-paragraph">上記のように<code>Field</code>関数を使用すると、詳細なバリデーションルールやメタデータをフィールドに追加できます。</p>



<h2 class="wp-block-heading">エンドポイントの柔軟性を高める設計のヒント</h2>



<p class="wp-block-paragraph">API をより使いやすくするためのヒントをご紹介します。</p>



<h3 class="wp-block-heading">リソース指向のアプローチ</h3>



<p class="wp-block-paragraph">各HTTPメソッドの意味に沿った処理内容にしましょう。</p>



<p class="wp-block-paragraph">HTTPメソッドと処理内容の関係は以下の通りです。</p>



<figure class="wp-block-table"><table><thead><tr><th>HTTPメソッド</th><th>処理内容</th></tr></thead><tbody><tr><td><strong>GET</strong></td><td>リソースを読み出すが変更はしない</td></tr><tr><td><strong>POST</strong></td><td>新規リソースを作成</td></tr><tr><td><strong>PUT</strong></td><td>リソースの更新 or 置換</td></tr><tr><td><strong>DELETE</strong></td><td>リソースの削除</td></tr><tr><td><strong>PATCH</strong></td><td>リソースの部分的な更新</td></tr></tbody></table><figcaption class="wp-element-caption">HTTPメソッドの処理内容</figcaption></figure>



<p class="wp-block-paragraph">これらを遵守することで「直感的で分かりやすいエンドポイント」が作成できます。</p>



<p class="is-style-icon_announce wp-block-paragraph">「単一責任の原則」の観点からも重要な事項です。</p>



<h3 class="wp-block-heading">パスパラメータとクエリパラメータを使い分ける</h3>



<p class="wp-block-paragraph">「パスパラメータ」と「クエリパラメータ」はそれぞれ用途や特性が異なります。</p>



<p class="wp-block-paragraph">基本的には以下の使い分けがされることが多いです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>パスパラメータ</strong>: リソースの「特定」</li>



<li><strong>クエリパラメータ</strong>：リソースの「操作」</li>
</ul>
</div></div>



<p class="wp-block-paragraph">リソースの特定とは、例えば「ユーザーID」や「製品ID」などを指定して、個別具体的なアイテムを取得してくるイメージです。</p>



<p class="wp-block-paragraph">一方のリソースの「操作」とは、「ページネーション」「フィルタリング」「ソート」などのリソースに対する加工のための追加情報を渡す形になります。</p>



<h3 class="wp-block-heading">バリデーションとエラー処理の強化</h3>



<p class="wp-block-paragraph">FastAPI では、<strong>Pydantic モデルを使った強力なバリデーションが可能</strong>です。</p>



<p class="wp-block-paragraph">不正 / 不完全なリクエストに適切なエラーを返すことで、システム全体としてのセキュリティを上げていきましょう。</p>



<h3 class="wp-block-heading">バージョニング</h3>



<p class="wp-block-paragraph">将来的な API の変更に備え、最初からバージョニングを組み込みましょう。</p>



<p class="wp-block-paragraph">URL にバージョン番号を含めることで API の新旧バージョンを並行して運用することや、徐々に移行することもできるようになります。</p>



<h3 class="wp-block-heading">セキュリティと認証</h3>



<p class="wp-block-paragraph">OAuth2 や JWT を活用し、安全なAPIエンドポイントを作成しましょう。</p>



<h2 class="wp-block-heading">API ルーティングの知識を設計に生かそう！</h2>



<p class="wp-block-paragraph">FastAPI を使った API ルーティングの基礎をお伝えしてきました。</p>



<p class="wp-block-paragraph">以上の内容を理解して上手に API 設計を行なっていきましょう。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django REST framework で CORS 対策をする方法</title>
		<link>https://cfxlog.com/python-django-rest-cors/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 07 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4704</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors.jpg" class="webfeedsFeaturedVisual" /></p>このような場合の対策をお伝えします。 Django REST framework（以下「DRF」とします）では、外部ライブラリを使うことで簡単に CORS 対策ができます。 本記事では CORS 対策の方法と、そもそも  [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django REST framework で CORS エラーが出ている…</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような場合の対策をお伝えします。</p>



<p class="wp-block-paragraph">Django REST framework（以下「DRF」とします）では、外部ライブラリを使うことで簡単に CORS 対策ができます。</p>



<p class="wp-block-paragraph">本記事では CORS 対策の方法と、そもそも CORS とはどのようなものかをお伝えします。</p>



<h2 class="wp-block-heading">DRF での CORS 対策の方法</h2>



<p class="wp-block-paragraph">DRF で CORS 対策するのはとても簡単で、以下の流れで行います。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li>ライブラリのインストール</li>



<li>INSTALLED APPS に追記</li>



<li>ミドルウェアに追記</li>



<li>CORS ポリシーを追記</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ちょっとしたコツもあるので、詳しく解説していきます。</p>



<h3 class="wp-block-heading">ライブラリのインストール</h3>



<p class="wp-block-paragraph">DRF の CORS 対策用に &#8220;django-cors-headers&#8221; ライブラリをインストールします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install django-cors-headers</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">django-cors-headers</span></span></code></pre></div>



<h3 class="wp-block-heading">INSTALLED APPS に追記</h3>



<p class="wp-block-paragraph">続いて settings.py の INSTALLED_APPS に django-cors-headers を追記して、Django プロジェクト内で有効化します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = &#91;
    ...
    "corsheaders",
    ...
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">INSTALLED_APPS = &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;corsheaders&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">記載する順番はどこでもOKです。</p>



<h3 class="wp-block-heading">ミドルウェアに追記</h3>



<p class="wp-block-paragraph">この手順では、<strong>追記する順番が大事</strong>になります。</p>



<p class="wp-block-paragraph">MIDDLEWARE CommonMiddleware より上に、CorsMiddleware を追記しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>MIDDLEWARE = &#91;
    ...
    "corsheaders.middleware.CorsMiddleware", # 追記
    "django.middleware.common.CommonMiddleware", # デフォルトで存在
    ...
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">MIDDLEWARE = &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;corsheaders.middleware.CorsMiddleware&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #6A9955"># 追記</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;django.middleware.common.CommonMiddleware&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #6A9955"># デフォルトで存在</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">Django のミドルウェアは上から順番に処理していきます。<br>CommonMiddleware は URL の末尾スラッシュの扱いや www の追加などを担当するミドルウェアです。</p>



<p class="wp-block-paragraph">仮に CorsMiddleware の前に CommonMiddleware が処理されると、CORS ヘッダがレスポンスに付与される前にリダイレクトなどの処理が行われてしまい、CORS ヘッダがうまく付与されない恐れがあります。</p>



<p class="wp-block-paragraph">そのため、CommonMiddleware の前に CorsMiddleware を記載しておく必要があるのです。</p>



<h3 class="wp-block-heading">CORS ポリシーを追記</h3>



<p class="wp-block-paragraph">どのドメインからアクセスを許可するかに応じて、大きく次の２パターンの設定方法があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li>全てのドメインからのアクセスを許可</li>



<li>特定のオリジンからのアクセスのみを許可</li>
</ul>
</div></div>



<p class="wp-block-paragraph">いずれかを採用して、settings.py ファイルに追記してください。</p>



<h4 class="wp-block-heading">全てのドメインからのアクセスを許可</h4>



<p class="wp-block-paragraph">特に制限をかける必要がない場合には、以下のように追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 全てのオリジンからのアクセスを許可
CORS_ALLOW_ALL_ORIGINS = True</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 全てのオリジンからのアクセスを許可</span></span>
<span class="line"><span style="color: #D4D4D4">CORS_ALLOW_ALL_ORIGINS = </span><span style="color: #569CD6">True</span></span></code></pre></div>



<h4 class="wp-block-heading">特定のオリジンからのアクセスのみを許可</h4>



<p class="wp-block-paragraph">一方で、特定のオリジンからのアクセスに限定したい場合には、以下のように追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 許可するオリジンを指定
CORS_ALLOWED_ORIGINS = &#91;
    "https://example.com/",
    "https://sub.example.com/",
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 許可するオリジンを指定</span></span>
<span class="line"><span style="color: #D4D4D4">CORS_ALLOWED_ORIGINS = &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;https://sub.example.com&quot;/</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<h2 class="wp-block-heading">そもそも CORS とは？</h2>



<p class="wp-block-paragraph">CORS（Cross-Origin Resource Sharing）について少し突っ込んでご説明します。</p>



<h3 class="wp-block-heading">目的はセキュリティ対策</h3>



<p class="wp-block-paragraph">原則として Web ページは、異なるドメインからのアクセスは拒否する仕組みになっています。</p>



<p class="wp-block-paragraph">もしも異なるドメインからのアクセスをすべて許可してしまうと、悪意のあるクライアントからのアクセスも許すことになってしまい不都合です。</p>



<p class="wp-block-paragraph">そこで「アクセスを許可したクライアントにだけ CORS ヘッダーを付与する」ことで、API にアクセスできるクライアントを限定することができます。</p>



<p class="wp-block-paragraph">具体的にはサーバー側で対象のクライアントからのアクセスがあった場合、Access-Control-Allow-Origin という HTTP ヘッダがレスポンスに含まれることになります。</p>



<p class="wp-block-paragraph">このHTTPヘッダを付与するのに使われるのが、最初にご紹介した &#8220;django-cors-headers&#8221; ライブラリになります。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">CORS は API サーバー側でアクセス制限するための仕組みでした。</p>



<p class="wp-block-paragraph">JavaScript フレームワークと DRF を併用する際によく遭遇する事項になりますので、もし困った場合には今回ご紹介した手順に従って CORS 対策を行ってみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【入門編】FastAPIスピードマスターガイド</title>
		<link>https://cfxlog.com/python-fastapi-quickstart/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 03 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[FastAPI]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[Webアプリ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4640</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-fastapi-quickstart.jpg" class="webfeedsFeaturedVisual" /></p>FastAPI はフルスタックフレームワークの Django に比べると直感的かつシンプルでわかりやすいフレームワークですが、公式チュートリアルを読むのはそれなりの時間もかかります。 そこで FastAPI のエッセンス [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-fastapi-quickstart.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>FastAPIの概要を知りたい</li>



<li>公式チュートリアルを読むのが面倒</li>



<li>簡単な使い方をマスターしたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">FastAPI はフルスタックフレームワークの Django に比べると直感的かつシンプルでわかりやすいフレームワークですが、公式チュートリアルを読むのはそれなりの時間もかかります。</p>



<p class="wp-block-paragraph">そこで FastAPI のエッセンスをサクッと学べるように、極力ムダを省き爆速でコーディングできるガイドをご用意しました。</p>



<h2 class="wp-block-heading">FastAPIの基本的な使い方</h2>



<p class="wp-block-paragraph">いよいよここからは FastAPI を実際に使う手順を解説します。</p>



<p class="wp-block-paragraph">Web 開発にあまり馴染みのない方でも極力わかりやすいように、深掘りして解説していきます。</p>



<h3 class="wp-block-heading">インストール</h3>



<p class="wp-block-paragraph">次のいずれかのコマンドでライブラリをインストールできます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># pipでインストールする場合
pip install fastapi uvicorn&#91;statndard&#93;

# Poetryでインストールする場合
poetry add fastapi "uvicorn&#91;standard&#93;"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># pipでインストールする場合</span></span>
<span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">fastapi</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">uvicorn&#91;statndard&#93;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Poetryでインストールする場合</span></span>
<span class="line"><span style="color: #DCDCAA">poetry</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">fastapi</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;uvicorn&#91;standard&#93;&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">uvicorn の後の [standard] をつけることで WebSockets、Gzip、Brotli、HTTP/2 などのサポートが追加されます。基本的につけておくと良いでしょう。</p>



<p class="is-style-icon_info wp-block-paragraph">Poetryで角括弧<code>[]</code>のついたコマンドを実行する際には、シェルが各括弧を特殊な意味で解釈しないように<code>""</code>で囲む必要があるので注意が必要です。</p>



<h4 class="wp-block-heading">uvicornをインストールする理由</h4>



<p class="wp-block-paragraph">FastAPIはASGIサーバー上で動作するので、<strong>ASGIサーバーとして機能するuvicornも同時にインストールする</strong>のが一般的です。</p>



<p class="wp-block-paragraph">ちなみにFastAPIとよく比較されるDjangoでは、伝統的にWSGIサーバー上で動作させることが多いです。ここでASGIとWSGIの違いをざっとまとめておきます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>ASGI</strong><br>非同期通信に対応しているので、複数のリクエストを同時処理が可能。<br>ウェブソケットなどの長期間の接続もサポート。</li>



<li><strong>WSGI</strong><br>同期処理にしか対応していないので、一度に1つのリクエストしか処理できない。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">つまり、<strong>たくさんのリクエストが集中するようなサービスを作るのであれば非同期処理に対応したASGIの方が優れています</strong>。</p>



<p class="wp-block-paragraph">ただし、WSGIはコードが簡潔で直感的に理解しやすいので、<strong>パフォーマンスを求めなかったり小規模な開発であればかえってWSGIの方が優れている</strong>こともあります。</p>



<h3 class="wp-block-heading">もっとも簡単なFastAPIのコード</h3>



<p class="wp-block-paragraph">試しに簡単なコードを書いてみましょう。<br>エンドポイントにアクセスすると<code>{"Hello":"World"}</code>とだけ表示されるものです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI

# FastAPIの初期化
app = FastAPI()


@app.get("/")
def read_root():
    return {"Hello": "World"}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># FastAPIの初期化</span></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.get</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;/&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">read_root</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> {</span><span style="color: #CE9178">&quot;Hello&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;World&quot;</span><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>@app.get</code>とすることで、引数内のアドレスにGETメソッドでアクセスがあった場合の動作を定義できます。</p>



<p class="wp-block-paragraph">つまりここではルート（<code>/</code>）にアクセスがあった場合には {Hello: World} を返す、という意味になるわけですね。</p>



<p class="wp-block-paragraph">なお、FastAPI では Python オブジェクトを JSON に変換して返却してくれるという仕様があります。そのためここでは辞書型がリターンされていますが、クライアントには JSON オブジェクトが返されます。</p>



<p class="is-style-icon_info wp-block-paragraph">実際に Hello World を表示させるには、ASGI サーバーを立ち上げる必要があります。</p>



<h3 class="wp-block-heading">ASGIサーバーの起動方法</h3>



<p class="wp-block-paragraph">ASGIサーバーを立ち上げるコマンドは以下になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># コマンドの形式
uvicorn &#91;Pythonファイル名&#93;:&#91;起動するインスタンス名&#93; --reload

# 実際のコマンド例
uvicorn main:app --reload</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># コマンドの形式</span></span>
<span class="line"><span style="color: #DCDCAA">uvicorn</span><span style="color: #D4D4D4"> &#91;Pythonファイル名&#93;:&#91;起動するインスタンス名&#93; --reload</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 実際のコマンド例</span></span>
<span class="line"><span style="color: #DCDCAA">uvicorn</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">main:app</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--reload</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>--reload</code>オプションをつけることで開発モードでアプリケーションを起動します。これにより、ソースコードが変更されるたびに uvicorn が再起動して変更内容が反映されます。</p>



<p class="wp-block-paragraph">さて、上記を実行した後にブラウザから<code>https://cfxlog.com/</code>にアクセスしてみてください。動作確認ができるはずです。</p>



<p class="is-style-icon_info wp-block-paragraph">ポートを変更したい場合には<code>--port 8001</code>のように指定することもできます。</p>



<h3 class="wp-block-heading">ドキュメントの表示方法</h3>



<p class="wp-block-paragraph">FastAPI では Swagger UIと ReDoc により、自動的にドキュメントが作成されます。<br>そのため、例えば開発サーバーを立ち上げている場合は以下の URL にアクセスするだけで簡単にドキュメントを確認できます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>Swagger UI</strong>：http://localhost:8000/docs</li>



<li><strong>ReDoc</strong>：http://localhost:8000/redoc</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ドキュメントを無効にしたり、エンドポイントを変更するには FastAPI に対して以下のように引数を渡します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI

# Swagger UI, ReDocを無効化
app_invalidate = FastAPI(docs_url=None, redoc_url=None)

# Swagger UI, ReDocをカスタムパスに変更
app_custompath = FastAPI(docs_url="/custom-docs", redoc_url="/custom-redoc")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Swagger UI, ReDocを無効化</span></span>
<span class="line"><span style="color: #D4D4D4">app_invalidate = FastAPI(</span><span style="color: #9CDCFE">docs_url</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">redoc_url</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Swagger UI, ReDocをカスタムパスに変更</span></span>
<span class="line"><span style="color: #D4D4D4">app_custompath = FastAPI(</span><span style="color: #9CDCFE">docs_url</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;/custom-docs&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">redoc_url</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;/custom-redoc&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">【重要概念】@appデコレーターについて</h2>



<p class="wp-block-paragraph">FastAPI を理解するための最重要概念は<code>@app</code>デコレーターです。</p>



<p class="wp-block-paragraph">この @app デコレーターにはいくつかの種類があり、それぞれの挙動や使い道を押さえておくと FastAPI による開発の幅が一気に開いていきます。</p>



<h3 class="wp-block-heading">ルーティングを行うデコレータ</h3>



<p class="wp-block-paragraph">API開発においては、HTTPメソッドをフルに活用して開発が行われます。</p>



<p class="wp-block-paragraph">以下、FastAPI のデコレータとHTTPメソッドの対応関係です。</p>



<figure class="wp-block-table"><table><thead><tr><th>HTTPメソッド</th><th>FastAPI デコレータ</th></tr></thead><tbody><tr><td>GET</td><td>@app.get</td></tr><tr><td>POST</td><td>@app.post</td></tr><tr><td>PUT</td><td>@app.put</td></tr><tr><td>PATCH</td><td>@app.patch</td></tr><tr><td>DELETE</td><td>@app.delete</td></tr></tbody></table><figcaption class="wp-element-caption">デコレータとHTTPメソッドの関係</figcaption></figure>



<p class="wp-block-paragraph">ルーティングについて詳しく知りたい方は、以下の記事も併せてご覧ください。</p>


<div class="swell-block-postLink">投稿が見つかりません。</div>


<p class="wp-block-paragraph">続いては、デコレータの引数について解説します。</p>



<p class="wp-block-paragraph">必須の引数である path の他にも、次のように多数のオプションを設定できます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>path</strong><br>リクエストを受け取る URL パスを定義します。</li>



<li><strong>response_model</strong><br>エンドポイントから返されるレスポンスのデータ形式を定義します。<br>Pydantic モデルを指定することになります。</li>



<li><strong>status_code</strong><br>成功時の HTTP ステータスコードを指定します。<br>デフォルト値は200番なので、例えば新しいリソースの作成（Create）の場合、&#8221;201&#8243;を指定することが多いです。</li>



<li><strong>tags</strong><br>エンドポイントをグループ分けするためのタグを設定できます。<br>API ドキュメントでグループ化されるので、管理が簡単になります。</li>



<li><strong>summary</strong> と <strong>description</strong><br>APIドキュメントに記載されるエンドポイントの概要と説明を記載します。</li>
</ul>
</div></div>



<h3 class="wp-block-heading">@app.on_eventデコレーター</h3>



<p class="wp-block-paragraph"><code>@app.on_event</code>デコレーターには二種類の値を設定できます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>startup</strong><br>アプリの起動時に実行する関数を定義します。<br>例えば、データベース接続の確立や初期化処理を行うために使われます。</li>



<li><strong>shutdown</strong><br>アプリの終了時に実行する関数を定義します。<br>例えば、データベース接続の解放やリソースのクリーンアップ用途に使われます。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">次のサンプルコードはアプリの起動・終了をprintするだけのものです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI

app = FastAPI()

@app.on_event("startup")
async def startup_event():
    print("アプリケーションが起動しました")

@app.on_event("shutdown")
async def shutdown_event():
    print("アプリケーションが終了しました")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.on_event</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;startup&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">startup_event</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;アプリケーションが起動しました&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.on_event</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;shutdown&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">shutdown_event</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;アプリケーションが終了しました&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">@app.middleware(&#8220;http&#8221;)デコレーター</h3>



<p class="wp-block-paragraph">@app.middleware(&#8220;http&#8221;) デコレーターを使うことで、簡単にミドルウェアの実装ができます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from fastapi import FastAPI, Request

app = FastAPI()

@app.middleware("http")
async def add_process_time_header(request: Request, call_next):
    # リクエストを受けたタイミングでやりたい処理
    ...
    response = await call_next(request)
    # レスポンスを作成した後にやりたい処理
    ...
    response.headers&#91;"Custom-Header"&#93; = "Some value"
    return response</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> fastapi </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> FastAPI, Request</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">app = FastAPI()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">@app.middleware</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;http&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_process_time_header</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">request</span><span style="color: #D4D4D4">: Request, </span><span style="color: #9CDCFE">call_next</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># リクエストを受けたタイミングでやりたい処理</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">    response = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> call_next(request)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># レスポンスを作成した後にやりたい処理</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">    response.headers&#91;</span><span style="color: #CE9178">&quot;Custom-Header&quot;</span><span style="color: #D4D4D4">&#93; = </span><span style="color: #CE9178">&quot;Some value&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> response</span></span></code></pre></div>



<p class="wp-block-paragraph">上記のサンプルコードではレスポンスを返す時にカスタムヘッダーを加える処理を行っています。</p>



<p class="wp-block-paragraph">call_next() 関数は FastAPI で特別な関数で、 response = await call_next(request) とすることでレスポンスが作成されるまで待つことができるようになります。</p>



<p class="wp-block-paragraph">これにより、response = await call_next(request) の前後で処理を書き分けることにより便利に扱うことができるようになります。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">以上、FastAPI の操作でよく使われるメソッドを中心にご説明してきました。</p>



<p class="wp-block-paragraph">Django などと比べるとかなり直感的に操作ができるので、初めて Web 系の開発にチャレンジしたい方にとってはフレームワークの有力な選択肢になってくるはずです。</p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
