バックオフィス業務のお悩みや、PCAの業務ソフトをお使いの皆様の
お悩み解決を提供する総合サイト

HTTP編の記事 では触れなかったHTTPリクエストヘッダーのContent-Type、Accept等で指定するデータ形式や、そのメディアタイプの解説記事となります。

 

HTTP/HTTPS通信では、リクエストボディにサーバーへ送るデータを設定し、レスポンスボディにサーバーからのデータが返されます。
PCAクラウド Web-APIでは、このデータの受け渡しに主に XML と JSON の形式を使用します。

XML形式

XMLは、以下の特徴を持つ構造化データの表現方法です。

• 開始タグと終了タグでデータを囲む
• 要素が階層的（ツリー構造）に配置される
• タグ名によってデータの意味が分かる
• 属性で追加情報を付与できる（※PCAクラウドWeb-APIでは属性は使用しません）

（XML形式のデータ例）

JSON形式 

JSONは、以下の特徴を持つ軽量なデータ形式です。

• {} でオブジェクトを表す
• "キー": 値 の組み合わせでデータを構造化する
• [] を使って配列を表し、ネストによって階層構造も表現できる
• 簡潔で読み書きしやすく、多くのWeb APIで利用されている

（JSON形式のデータ例）

メディアタイプ

送受信するデータの形式は、HTTPリクエストヘッダーの Content-Type と Accept で指定します。

• Content-Type：サーバーへ送るデータの形式
• Accept：サーバーから受け取るデータの形式

これらのヘッダーには「メディアタイプ」と呼ばれる識別子を指定します。

メディアタイプの一例

• application/xml → XML形式のデータ
• application/json → JSON形式のデータ
• text/plain → プレーンテキスト

その他

OAuth 認証など、一部の PCAクラウドWeb-API では Content-Type にapplication/x-www-form-urlencoded や text/plain を指定するものがあります。

application/x-www-form-urlencoded の場合
このメディアタイプのデータ形式は、次の特徴を持ちます。

• キー=値 の組み合わせでデータを表す

• 複数の項目は & で区切る
• JSON や XML のような階層構造は持たない（フラットな構造）

（上記は、form形式の特徴です）

• 値は URL エンコードされる

 

（実際にはクエリーパラメータへURLエンコードします。見易くするよう改行しています。）

（メディアタイプapplication/x-www-form-urlencodedのデータ例）