ペイロードとは？API初心者向けにリクエスト本文・送信データを解説 | 仕組み解説

ペイロードとは、通信やAPIで送るデータのうち、実際に届けたい中身のことです。

APIでは、リクエスト本文やレスポンス本文に入るJSONデータを指して使われることが多いです。

ペイロードとは

ペイロードは、荷物で例えると「箱の中身」です。

通信には、宛先や形式などの情報も含まれます。その中で、本当に相手へ渡したいデータ本体がペイロードです。

たとえば、新しいユーザーを作成するAPIへ次のJSONを送るとします。

{
  "name": "Ada",
  "email": "ada@example.com"
}

このJSON部分がペイロードと呼ばれることがあります。

HTTP通信では、ヘッダーと本文があります。

部分	役割
ヘッダー	データ形式、認証情報、ブラウザ情報など
ペイロード	実際に送りたいデータ本体

たとえば、Content-Type: application/json はヘッダーです。ユーザー名やメールアドレスのJSONはペイロードです。

ペイロードは、リクエストだけでなくレスポンスにもあります。

リクエストでは、クライアントからサーバーへ送るデータです。レスポンスでは、サーバーからクライアントへ返すデータです。

ペイロードという言葉は、文脈によって少し意味が変わります。

まずは「実際に運びたいデータ本体」と理解しておけば問題ありません。

ペイロードは、API通信などで送るデータ本体です。ヘッダーは補足情報、ペイロードは中身と分けて考えると、HTTPやAPIの理解が進みます。