
Content-Type と Authorization とは?API に POST するときのヘッダーと、400・401・403・415 の意味
画面(フロントエンド)から API(バックエンド)にデータを送るコードには、Content-Type: application/json や Authorization: Bearer 〜 という行がよく出てきます。
書き忘れたり、値が違っていたりすると、415 や 401 といった番号が返ってきて、リクエストが受け付けられません。これらの行はヘッダーと呼ばれ、リクエストの本文とは別に、「中身の形式」や「誰からのリクエストか」をサーバーに伝える添え書きです。
この記事では、リクエストがどのような形でサーバーに届くのか、Content-Type と Authorization がそれぞれ何を伝えているのか、合わないときにどの番号で断られるのかを説明します。検証用の小さな API サーバーと、curl・Chromium(Chrome のもとになっているブラウザー)で実際に送った結果も、あわせて紹介します。本文の[1]のような番号は、押すと出典のページが開きます。
ブラウザーが別のオリジンの API を呼ぶときの決まり(CORS)は、以前の記事「CORSとは?同一オリジンポリシーと、画面とAPIを分けたときに出るエラーの意味」で扱いました。この記事のヘッダーは、その中の「プリフライト」にも関係します。
まず用語をそろえる
リクエストと応答:ブラウザーなどがサーバーに送る依頼がリクエスト、サーバーからの返事が応答です。
エンドポイント:API の URL のことです。窓口の住所にあたります。
メソッド:リクエストで「何をしたいか」を表す語です。データを読む GET、新しく送る POST、書き換える PUT・PATCH、消す DELETE などがあります。
本文(ボディ):リクエストや応答で運ぶデータそのものです。API では JSON(文字で書いたデータの形式)で書くことが多くあります。
ヘッダー:本文とは別に付ける「名前: 値」の形の添え書きです。
ステータスコード(応答の番号):サーバーが応答の先頭に書く3桁の番号です。200 番台は成功、400 番台は「リクエストの側に問題がある」ことを表します。
資格情報:「誰からのリクエストか」をサーバーに示すための情報です。パスワード、Cookie、トークンなどがあります。
トークン:ログインに成功したときなどにサーバーが発行する文字列です。以後のリクエストに付けて、本人であることを示します。
リクエストは「宛先・添え書き・中身」でできている
ブラウザーやプログラムが API に送るリクエストは、文字で書かれたメッセージです。HTTP/1.1 の仕様(RFC 9112)は、メッセージを、最初の1行(開始行)、0行以上のヘッダーの行、ヘッダーの終わりを示す空の行、そして省略できる本文、という順に並べたものと定めています[1]。
実際に、検証用の API サーバーに curl(コマンドで HTTP のリクエストを送る道具)で JSON を POST すると、次のリクエストが送られました。
POST /api/items/new/ HTTP/1.1
Host: localhost:8000
User-Agent: curl/8.5.0
Accept: */*
Content-Type: application/json
Authorization: Bearer abc123
Content-Length: 27
{"name":"pear","price":300}1行目(開始行):メソッド(POST)と、送り先のパス(/api/items/new/)と、HTTP の版
2行目から空の行まで(ヘッダー):「名前: 値」の添え書き。Content-Type は本文の形式、Authorization は資格情報、Content-Length は本文の長さを表す
空の行のあと(本文):送りたいデータそのもの
荷物にたとえると、開始行は宛先、ヘッダーは送り状の記入欄、本文は箱の中身です。RFC 9110(HTTP の意味を定めた仕様)も、ヘッダーには、本文を受け取る前に知っておく必要のあることを書くと説明しています[4]。サーバーは、送り状を読んでから箱を開けます。
なお、HTTP/2 や HTTP/3 では、開始行にあたる情報を特別な名前のヘッダーとして送るなど、送るときの形は変わります[4]。それでも、「宛先・添え書き・中身」という組み立ては同じです。

ヘッダーの名前は、大文字と小文字を区別しません[4]。Content-Type と書いても content-type と書いても、同じヘッダーとして扱われます。実験でも、ヘッダーの名前をすべて小文字にしたリクエストが、同じように受け付けられました。
応答も同じ形をしています。1行目が「HTTP/1.1 201 Created」のようなステータスコードの行になり、そのあとにヘッダー、空の行、本文が続きます。
Content-Type と Authorization は、どのリクエストに付けるのか
この2つのヘッダーが要るかどうかは、メソッドの種類そのものではなく、次の2点で決まります。
Content-Type:リクエストに本文があるかどうか
Authorization:送り先のデータが、資格情報を求めるように守られているかどうか
Content-Type:本文を送るときに付ける
Content-Type は、本文の形式を伝えるヘッダーです。RFC 9110 は、本文を含むメッセージを送る側は、形式が分からない場合を除いて、Content-Type を付けるべきだとしています[4]。
本文を送るかどうかは、メソッドの役割によって違います。POST は、送った本文をサーバーに処理させるメソッドです[4]。PUT は、送った本文の内容で、データを作成したり置き換えたりさせるメソッドです[4]。どちらも本文を送ることが前提で、データの一部を書き換える PATCH も、変更の内容を本文で送ります。
一方、GET のリクエストに本文を付けても、仕様の上で決まった意味はなく、受け付けない実装もあるとされています[4]。DELETE についても、同じ説明がされています[4]。そのため、Content-Type が必要になるのは、主に本文を送る POST・PUT・PATCH のリクエストです。
Authorization:守られたデータに送るときに付ける
Authorization は、誰からのリクエストかを伝えるヘッダーです。要るかどうかは、メソッドではなく、送り先のデータをサーバーがどう守っているかで決まります。
誰でも見てよい商品の一覧などは、資格情報なしで読めるように作れる。この場合、GET に Authorization は要らない
会員だけが見られるデータは、GET でも Authorization が必要になる
データを作る・書き換える・消す操作は、誰が行ったかを確かめ、権限を確認するために、資格情報を求めるように作るのが基本になる
このように、読み出しのリクエストでも、データが守られていれば Authorization が要ります。

Content-Type:本文の「形式」を伝える
メディアタイプ:「種類/細かい種類」の書き方
Content-Type の値は、メディアタイプ(MIME タイプとも呼ぶ)という書き方で表します。メディアタイプは、「text」や「application」などの大まかな種類と、その中の細かい種類を、スラッシュ(/)でつないだものです[3]。API でよく使うのは、次の4つです。
application/json:JSON で書いたデータ。API の本文でよく使われる
application/x-www-form-urlencoded:「name=pear&price=300」のように、名前と値を「&」でつないだ形。HTML のフォームの既定の送り方
multipart/form-data:ファイルなどを含められる、いくつかの部分に区切った形。画像のアップロードなどで使う
text/plain:ただの文字。データの構造を持たない
サーバーは、Content-Type を見て本文の読み方を決める
RFC 9110 は、Content-Type が示すメディアタイプは、データの形式と、受け手がそのデータをどう処理するかの両方を決めるものだとしています[4]。同じ「{"name":"pear"}」という文字の並びでも、application/json と書かれていれば JSON として読み、text/plain と書かれていれば、ただの文字として扱います。
そのため、API の側が「JSON だけを受け付ける」と決めていると、Content-Type が application/json 以外のリクエストは、中身が JSON であっても断られます。MDN は、サーバーの実装や設定がコンテンツの種類の扱いに厳密な場合は 415 が返る可能性があると説明しています[2]。

合わないときの番号:415 と 400
検証用の API サーバーは、JSON とファイル付きの形(multipart/form-data)だけを受け付けるようにしました。そこへ、中身は同じ JSON のまま、Content-Type だけを変えて送ると、次のようになりました。
Content-Type を application/json にした → 201 Created(作成できた)
Content-Type を text/plain にした → 415 Unsupported Media Type
Content-Type を付けずに curl で送った(curl が application/x-www-form-urlencoded を付ける)→ 415 Unsupported Media Type
Content-Type は正しいが、JSON の最後のかっこを書き忘れた → 400 Bad Request
JSON は正しいが、数を入れる price に「三百円」という文字を入れた → 400 Bad Request
415 Unsupported Media Type は、そのエンドポイントのそのメソッドでは受け付けていない形式の本文が届いたため、サーバーが処理を断ったことを示す番号です[4]。原因は、Content-Type に書いた形式のこともあれば、中身を調べた結果のこともあります[4]。
400 Bad Request は、サーバーがリクエストの側の誤りと判断して、処理できない、または処理しないことを示す番号です[4]。MDN は、400 を受け取ったら、リクエストを変えずに繰り返しても同じエラーで失敗すると考えるべきだとしています[5]。
つまり、目安として、415 は「形式の札が受け付けられない」、400 は「札は合っているが、中身が読めない・正しくない」と見分けることができます。実験の 400 の応答の本文には、「JSON parse error」(JSON として読めない)や「A valid integer is required.」(整数を入れてください)と、理由が書かれていました。

fetch で付け忘れると、text/plain になる
ブラウザーの JavaScript で使う fetch(サーバーにリクエストを送る命令)では、Content-Type の付け忘れに気づきにくいことがあります。JSON.stringify で文字にした本文を、ヘッダーを書かずに送ると、ブラウザーは Content-Type を text/plain;charset=UTF-8 にして送ります。Fetch Standard(ブラウザーのリクエストの送り方を定めた標準)が、本文がただの文字列のときは、この値を使うと定めているためです[6]。
Chromium で試すと、送られた Content-Type は「text/plain;charset=UTF-8」で、API からは 415 が返りました。中身はたしかに JSON ですが、送り状には「ただの文字」と書かれているため、JSON だけを受け付ける API は断ります。JSON を送るときは、次のように Content-Type を自分で書きます。
fetch("https://api.example.com/items/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ name: "pear", price: 300 }),
});
ファイルを送るときは、反対に自分で書かない
ファイルを送るときに使う FormData(フォームの値やファイルをまとめる入れ物)では、反対に、Content-Type を自分で書いてはいけません。multipart/form-data は、本文をいくつかの部分に分けて運ぶ形式で、部分と部分の区切りに使う文字列(boundary)を、Content-Type の中に書き添える必要があるためです。
ブラウザーは、FormData を本文にすると、「multipart/form-data; boundary=」のあとに区切りの文字列を付けた値を、自動で Content-Type に入れます[6]。MDN も、FormData で送るときは Content-Type を明示的に設定しないよう注意し、設定すると、ブラウザーが区切りを含めた Content-Type を設定できなくなると説明しています[7]。
実験では、自分で「multipart/form-data」とだけ書いて送ると、区切りの文字列がないため、400 Bad Request(「Invalid boundary in multipart: None」)になりました。書かずに送ると、ブラウザーが「multipart/form-data; boundary=----WebKitFormBoundary…」を付け、受け付けられました。

Accept:返してほしい形式を伝える
Content-Type が「送る本文の形式」なのに対し、Accept は「応答として返してほしい形式」を伝えるヘッダーです[8]。「Accept: application/json」なら、JSON で返してほしいという意味になります。
サーバーが、求められた形式で返せないときは、406 Not Acceptable という番号を返すことがあります[4]。実験で、JSON しか返さない API に「Accept: application/xml」を付けて送ると、406 が返りました。415 は「送った形式が受け付けられない」、406 は「返してほしい形式で返せない」です。
Authorization:「誰からのリクエストか」を伝える
書き方は「認証の種類+資格情報」
Authorization は、サーバーに対して自分を認証してもらうための資格情報を送るリクエストのヘッダーです[9]。値は、まず認証の種類(スキーム)の名前を書き、空白を空けて、資格情報を書きます。
Authorization: Bearer abc123この例では、「Bearer」が認証の種類の名前、「abc123」がトークンです。ほかの種類は、あとの「Bearer 以外の種類」で紹介します。
Bearer は「持参人」
Bearer は、英語で「持参人」という意味です。Bearer トークンの使い方を定めた RFC 6750 は、Bearer トークンを、持っている人なら誰でも使えるトークンと定義しています[10]。窓口で「この札を持っている人を、本人として扱う」という意味の札です。
そのため、トークンが他人に知られると、その人も本人として扱われます。RFC 6750 は、Bearer トークンを付けてリクエストを送るときは、必ず TLS(https の暗号化)などを使うよう求めています[10]。

Bearer 以外の種類
Authorization の先頭に書く認証の種類は、Bearer だけではありません。MDN は、よく使われる種類として Basic・Bearer・Digest などを挙げ、Amazon Web Services(AWS)のように、サービスが独自に定めた種類もあると説明しています[14]。代表的なものは次のとおりです。
Basic:利用者名とパスワードの組を、base64 という形式で文字に置き換えて送る[14]。たとえば「tanaka:pass」は「Authorization: Basic dGFuYWthOnBhc3M=」になる
Digest:パスワードそのものではなく、パスワードなどから計算した値を送る。RFC 7616 は、この仕組みでパスワードがそのまま送られることはないと説明している[15]
Token など、ソフトウェアが決めた名前:Python で API を作る道具の Django REST framework では、トークン認証で、初期設定で「Authorization: Token 〜」と書く[12]
AWS4-HMAC-SHA256 など、サービスが決めた名前:AWS の API では、リクエストの内容と AWS の資格情報から署名を計算し、「Authorization: AWS4-HMAC-SHA256 〜」の形で付けて送る[16]
Basic で注意したいのは、base64 が暗号ではないことです。元の文字に戻せる変換のため、MDN は、利用者名とパスワードが実質的にそのまま送られることになり、Basic 認証は安全ではないとしています[14]。使うときは、HTTPS で送ることが前提になります[14]。MDN はさらに、CSRF への備えなどの対策がない場合は、大切な情報を守るために Basic 認証を使わないよう勧めています[14]。
どの種類を使うかは、API の側が決めます。API の説明書に書かれた種類で送り、401 が返ったときは、応答の WWW-Authenticate を見ると、API が求めている種類が分かります(401 と WWW-Authenticate は、あとの節で説明します)。

書き方が少し違うだけでも、401 になる
検証用の API サーバーで、Authorization の書き方を変えて試すと、次のようになりました。
「Authorization: Bearer abc123」→ 201 Created(受け付けられた)
Authorization を付けない → 401(「Authentication credentials were not provided.」)
「Authorization: abc123」と、Bearer を書き忘れた → 401(同じく、資格情報がないと扱われた)
「Authorization: Bearer wrong」と、存在しないトークンを書いた → 401(「Invalid token.」)
「Authorization: Token abc123」「Authorization: Basic dGFuYWthOnBhc3M=」と、ほかの種類で送った → 401(Bearer だけを受け付ける作りのため、資格情報がないと扱われた)
3や5のように、認証の種類の名前を書き忘れたり、違う種類で送ったりすると、サーバーは「Bearer の資格情報が付いていない」と判断します。トークンの値が正しくても、書き方が違えば読まれません。なお、認証の種類の名前の大文字と小文字は、仕様では区別しないことになっています[4]。実験でも「bearer abc123」は受け付けられましたが、仕様の例どおり「Bearer」と書いておくのが無難です。
401 と 403 の違い
401:資格情報がない、または正しくない
401 Unauthorized は、有効な資格情報が付いていないため、サーバーがリクエストを処理しなかったことを示す番号です[4]。名前は「Unauthorized(許可されていない)」ですが、意味は「誰なのかが確認できない」に近いものです。
401 を返すサーバーは、WWW-Authenticate というヘッダーで、どの種類の資格情報を出せばよいかを示す必要があります[4]。実験の 401 の応答にも、「WWW-Authenticate: Bearer」が付いていました。「Bearer トークンを付けて出直してください」という返事です。
403:誰かは分かったが、その操作は許されていない
403 Forbidden は、サーバーがリクエストを理解したうえで、処理を断ったことを示す番号です[4]。資格情報が付いていた場合は、その資格情報では許可できないと判断したことになります[4]。ただし、資格情報とは関係のない理由で断る場合にも、403 が使われることがあります[4]。MDN は、401 との違いを、認証し直しても結果が変わらないことだと説明しています[11]。
実験では、閲覧だけを許した利用者のトークンで DELETE(削除)を送ると、403 になりました。同じ DELETE を、権限のある利用者のトークンで送ると、204 No Content(成功し、返す本文はない)になりました。トークンは正しく、誰なのかも分かっていますが、その人には削除の権限がない、という場面です。
Bearer トークンについては、RFC 6750 も同じ分け方をしています。トークンが期限切れ・取り消し済み・壊れているなどの場合は、401 を返すべきだとしています[10]。トークンで許された範囲を超える操作を求められた場合は、403 を返すべきだとしています[10]。

ログインしていなくても 403 が返ることがある
ただし、ログインしていないときに、いつも 401 が返るとは限りません。401 には WWW-Authenticate を付ける決まりがあるため、Cookie でログインを保つ作りのように、示す種類がない場合は 403 を返す作りもあります。たとえば、前に触れた Django REST framework は、Cookie(セッション)でのログインを使う場合、ログインしていないリクエストを断るときに 403 Forbidden を返すと説明しています[12]。403 が返ったときは、権限だけでなく、そもそも資格情報が届いているかも確かめる必要があります。
番号から原因を絞り込む
ここまでの番号を、確かめる点とあわせてまとめます。
400 Bad Request:中身が読めない・正しくない。JSON の書き方(かっこ・引用符・最後のカンマ)と、項目の名前や値の種類を確かめる。応答の本文に理由が書かれていることが多い
401 Unauthorized:資格情報がない・正しくない。Authorization が付いているか、「Bearer 」と空白まで書いたか、トークンの期限が切れていないかを確かめる
403 Forbidden:資格情報は分かったが、その操作の権限がない。どの利用者のトークンで送ったか、その利用者の権限を確かめる。作りによっては、ログインしていないときにも返る
406 Not Acceptable:返してほしい形式(Accept)に応えられない。Accept の値を確かめる
415 Unsupported Media Type:本文の形式(Content-Type)が受け付けられない。Content-Type が application/json になっているか、fetch で書き忘れていないかを確かめる
番号を見るときは、ブラウザーの開発者ツールのネットワークの欄で、実際に送ったリクエストのヘッダーと、応答の本文をあわせて見ると、原因を絞り込みやすくなります。


ブラウザーから送るときは、プリフライトも関係する
画面と API のオリジン(方式・ホスト・ポートの組み合わせ)が違うときは、もう1つ気をつけることがあります。CORS の記事で説明したように、Content-Type が application/json のリクエストや、Authorization を付けたリクエストは、ブラウザーが本番の前に OPTIONS というメソッドで確かめるプリフライトの対象になります。MDN は、Content-Type が CORS で「安全なヘッダー」(セーフリストのヘッダー)として扱われるのは、値が application/x-www-form-urlencoded・multipart/form-data・text/plain のどれかのときだけだと説明しています[2]。
プリフライトでは、ブラウザーが「content-type と authorization を付けて送りたい」と尋ね、API は Access-Control-Allow-Headers というヘッダーで、受け付けるヘッダーの名前を返します。実験で、API の側の許可に authorization を入れずに試すと、本番の POST は送られず、ブラウザーには次のエラーが出ました。
Request header field authorization is not allowed by Access-Control-Allow-Headers in preflight response.このとき、画面のプログラムには 401 や 403 のような番号は返らず、fetch そのものがエラーになります。本番のリクエストが、サーバーに送られていないためです。番号が返らず CORS のエラーが出ているときは、ヘッダーの値の誤りではなく、プリフライトの許可を疑います。

Authorization は「*」で許さず、名前を書く
Access-Control-Allow-Headers には、「*」(すべてのヘッダー)と書くこともできます。ただし、Fetch Standard は、Authorization を「*」では許されないヘッダーと定めています[6]。MDN も、Authorization はワイルドカードで表すことができず、常に明示的に並べる必要があるとしています[13]。
一方で、MDN の対応状況の表では、この決まりは主なブラウザーで初期設定では実装されていないとされています[13]。実験でも、Chromium は「*」だけで Authorization を付けた POST を通しました。今のブラウザーで動いていても、仕様どおりの扱いをするブラウザーでは止まるおそれがあるため、Authorization は名前を書いて許可しておくのが確実です。
まとめ
リクエストは、開始行(宛先)・ヘッダー(送り状)・本文(中身)でできている。ヘッダーは「名前: 値」の添え書き
Content-Type は本文の形式を伝え、本文を送るリクエストに付ける。Authorization は、送り先のデータが守られているときに付ける
形式が受け付けられないと 415、形式は合っていても中身が読めない・正しくないと 400
fetch で文字列を送ると text/plain になるため、JSON なら application/json を書く。FormData では反対に書かない
Authorization は「認証の種類+資格情報」。Bearer は「持っている人を本人として扱う」札で、https で送る。ほかに Basic・Digest などの種類があり、どれを使うかは API が決める
401 は「誰なのか確認できない」、403 は「誰かは分かったが、その操作は許されていない」
画面と API のオリジンが違うときは、Content-Type と Authorization をプリフライトで許可しておく

ヘッダーは、サーバーが本文を開ける前に読む送り状です。サーバーは、送り状に書かれた形式で中身を読み、書かれた資格情報で相手を確かめます。返ってきた番号を「送り状のどの欄が合わなかったか」と読むと、エラーの原因を絞り込みやすくなります。
免責事項
この記事は、筆者が個人として調べたことや経験をもとに、執筆時点の内容をまとめたものです。分かりやすさを優先し、細かい条件や例外を省いている場合があります。
動作は、検証用の API サーバーと curl・Chromium で確かめたもので、サーバーの作りや設定、ブラウザーによって変わることがあります。実際の開発では、公式の文書で最新の内容を確認し、本番の前に検証してください。
製品の仕様などは変わることがあります。この記事の内容を利用して生じた損害については、責任を負いかねます。
NDシステムズについて
NDシステムズは、福岡県久留米市を拠点に、ホームページの制作、業務に合わせた事務のシステムの開発、AI・DX支援を行っています。まずはお気軽に無料相談でご相談ください。