ForHosting KIT · 開発者向けツール

HTTPヘッダーの生データをキーと値のオブジェクトに変換

HTTPヘッダーの生テキストを貼り付けると、デバッグ、テスト、スクリプト、APIツールですぐ使える安定したJSONオブジェクトを取得できます。名前は小文字に統一し、値の前後の空白を取り除き、Set-Cookieのような重複名は上書きせず入力順の配列として保存します。空でない各行は標準のName: Value形式でなければなりません。不正な行がある場合は、部分的な結果を返さず、分かりやすいエラーを返します。処理は決定的で、ネットワークを使用しません。

● Beta無料・ブラウザ内で実行
ご利用方法 ウェブAPIメールTelegramアプリ 近日

コピーしたヘッダーブロックを扱いやすい構造化データに変換します

ブラウザーの開発者ツール、コマンドラインクライアント、リバースプロキシ、サーバーログでは、HTTPヘッダーがプレーンな行として表示されることがよくあります。人が確認するには便利ですが、コードから検索、比較、保存するには扱いにくい形式です。この解析機能は、有効なName: Value行を1つのheadersオブジェクトのプロパティへ変換します。HTTPのフィールド名は大文字と小文字を区別しないため、名前は小文字に統一され、Content-Typeとcontent-typeは同じプロパティになります。値の前後の空白は除去しますが、値の途中にあるコロンはそのまま残します。日時、URL、認証方式など、正当な句読点を含む値を壊さないためです。結果はテスト用fixtureへ直接コピーしたり、別のスクリプトへ渡したり、期待する応答と比較したりできます。メッセージ本文との区切りとして一般的な末尾の空行は許可します。一方、ブロック途中の空行や不正な行は拒否し、不完全な解析が成功したように見えることを防ぎます。

重複するヘッダーを失わずに保持します

通常のJavaScriptオブジェクトは1つのキーに1つの値しか保存しないため、単純な解析方法では同じ名前が現れるたびに以前の値を上書きしてしまいます。この挙動は重要なプロトコル情報を気付かないまま失わせる可能性があります。本機能では、ヘッダーが1回だけなら文字列を返し、大文字と小文字を区別せず同名が再び現れた時点で、そのプロパティを配列へ変更します。以後の値は元の順序で追加します。Set-Cookie、Warning、Linkなど、繰り返されるどのフィールドにも適用し、値をコンマで自動結合しません。フィールドごとに結合規則が異なり、特にSet-Cookieは一般的なコンマ区切りリストとして扱えないためです。コロンがあれば空の値も有効なので、X-Optional:はエラーではなく空文字列になります。日付、cookie、メディアタイプ、品質の重み、認証情報の意味までは解析しません。値をテキストのまま保ち、そのヘッダーを理解する後続処理に委ねます。

不正な行を早期に検出し、安全に結果を利用できます

信頼できる解析には、正しい変換だけでなく不正入力の確実な拒否も必要です。各行は有効なHTTPフィールド名で始まり、直後にコロンと値が続かなければなりません。フィールド名にはHTTPで許可されたtoken文字を使用できますが、空白、タブ、括弧、区切り文字、先頭のインデントは使用できません。現在は廃止された折り返し継続行は、直前の値へ連結せず拒否します。曖昧な結果を避け、正規化済みの現代的なヘッダーブロックを入力していただくためです。検証に失敗すると、エラーは該当行を示し、ペアと名前のどちらが不正かを説明します。部分オブジェクトは返しません。そのため、ブロックの一部だけを受け入れる方が危険なインポート処理や自動テストにも適しています。処理はローカルかつ決定的で、ネットワーク要求、時刻依存フィールド、乱数、外部検索はありません。同じテキストはブラウザーでもAPIでも同じJSON構造となり、APIの基本料金は$0.002です。

APIテスト用fixtureを作成します

HTTPトレースからコピーしたヘッダーを、決定的な応答テストで使える構造化JSONへ変換します。

繰り返される応答フィールドを確認します

Set-Cookie、Link、Warningの各出現を順番どおり保持し、変換時の値の消失を防ぎます。

取り込む診断情報を検証します

ログ断片をデバッグ、サポート、可観測性の工程へ渡す前に、不正なヘッダー行を拒否します。

重複するヘッダー名はどのように表現されますか?

1回だけなら文字列です。同名が繰り返されると、入力順を保った配列へ変わります。

ヘッダー名は大文字と小文字を区別しますか?

いいえ。名前は小文字に統一されるため、Content-Typeとcontent-typeは同じヘッダーとして扱われます。

ヘッダー値にコロンを含められますか?

はい。最初のコロンだけが名前と値を区切り、それ以降のコロンは値に残ります。

不正な行があるとどうなりますか?

該当行を示す入力エラーで要求全体が失敗します。部分的なheadersオブジェクトは返しません。

cookieやコンマ区切りの値を分割しますか?

いいえ。前後の空白以外はテキストのままです。物理的に繰り返された行だけを配列にします。

APIの利用料金はいくらですか?

1回の基本料金は$0.002です。ブラウザー版はローカルで動作し、ヘッダーブロックをネットワークへ送りません。

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

POSThttps://api.kit.forhosting.com/dev2/http-header-parse

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

curl -X POST https://api.kit.forhosting.com/dev2/http-header-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Content-Type: application/json\r\nCache-Control: no-cache\r\nSet-Cookie: theme=dark\r\nSet-Cookie: session=abc123"}'
{
  "text": "Content-Type: application/json\r\nCache-Control: no-cache\r\nSet-Cookie: theme=dark\r\nSet-Cookie: session=abc123"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev2.http_header_parse",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →