ForHosting KIT · データ変換・整形

ドット区切りキーをネストされたJSONへ変換

ドット区切りの名前から入れ子の記録を組み立て直します。user.contact.emailはuserの中のcontactの中に戻り、activeと得点42は最上位に残ります。例では5件の項目を処理します。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日

処理はブラウザ内で完結します。ファイルは送信されません。無料でご利用いただけます。

各ドット区切りキーを決定的に展開し、文字列、数値、真偽値、null、配列、オブジェクトをそのまま保ちます。曖昧なパスはデータを黙って上書きせず、エラーとして通知します。環境変数、フォーム出力、設定、分析ツール、データベース照会などのフラットなレコードを、検証や処理の前に復元する際に便利です。

ドット区切りの名前を入れ子の文書に戻します

各プロパティ名は、ドットで区切られたセグメントからなるパスとして解釈されます。たとえばaccount.profile.nameは、account内のprofileにあるnameプロパティになります。ドットを含まないキーは最上位に残ります。

値の型は変換されません。数値は数値、falseは真偽値、nullはnullのままで、配列も順序と内容を維持します。結果のjsonには復元された文書が入り、keysには処理したフラットプロパティ数が入ります。

数字に見えるセグメントも配列インデックスではなく通常のオブジェクトキーとして扱うため、入力に明示されていないコレクション形式を推測しません。この仕様により、設定、データベースの別名、フォーム送信でも安定した結果が得られます。処理は決定的であり、ネットワーク、地域設定、時刻、挿入順序の副作用に依存しません。

データを失う前に競合パスを検出します

あるキーがパスを最終値として定義し、別のキーが同じパスをオブジェクトとして必要とすると、復元結果は曖昧になります。明示的に指定されたオブジェクト内の衝突も拒否されます。ただし既存メンバーと競合しない場合、そのオブジェクトはドット付きの子孫で拡張できます。

そのため、オブジェクトのsettingsへsettings.themeを追加できます。空のキー、先頭または末尾のドット、連続するドットは名前のないセグメントを作るため使用できません。__proto__、prototype、constructorも、指定オブジェクト内を含むすべての階層で拒否されます。

これらの検査により問題を早期に可視化し、正常な出力の各位置に曖昧でない出所が1つだけあることを保証します。

移行処理やアプリケーションの流れで活用できます

フラットキーはシステム境界で頻繁に現れます。SQL照会はcustomer.address.cityのような別名を返し、ログや分析基盤は索引作成のためイベントを平坦化します。HTMLフォームはグループ化した項目をドット付きの名前で表し、デプロイシステムは構造化設定を個別変数として扱います。

検証エラーが元レコードを指すようになり、不完全な構造が後段へ進むのを防げます。バッチ処理では、課金単位が1項目で各応答が1文書を表すため、フラットレコードごとに呼び出してください。文字列値のドットは安全で、パスとして扱われるのはプロパティ名だけです。

数字のパスは配列になりますか?

いいえ。 インデックスか識別子かを推測せず、各セグメントをオブジェクトキーとして保持します。

値の型は保持されますか?

はい。 文字列、有限数、真偽値、null、配列、オブジェクトを型変換せずコピーします。

キーに空のパス部分を含められますか?

いいえ。 空のキー、連続するドット、先頭や末尾のドットは曖昧なため拒否されます。

userとuser.nameのように名前がぶつかるとどうなりますか?

最後に読んだ名前を勝手に採用せず、はっきりしたエラーとして受け付けません。同じ場所が値と入れ子の両方になることはできないため、成功した結果ではどの位置にも出どころが1つだけになります。

値の種類はそのまま保たれますか?

はい、勝手に変換することはありません。数値は数値、偽は偽、空の値は空のままで、一覧も順番と中身を保ちます。

ドットを含む値は分割されますか?

分割されません。経路として読み取るのは名前だけで、値の文字にドットが含まれていても、そのままの文字として残ります。

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

POSThttps://api.kit.forhosting.com/data/unflatten-to-json

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

curl -X POST https://api.kit.forhosting.com/data/unflatten-to-json \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"flat":{"user.name":"Ada","user.contact.email":"ada@example.com","active":true}}'
{
  "flat": {
    "user.name": "Ada",
    "user.contact.email": "ada@example.com",
    "active": true
  }
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.unflatten_to_json",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

{"account.name":"Ada"}のようなフラットなJSONオブジェクトを、アプリケーションが必要とするネスト構造へ変換します。

ドットパスを通常のJSON文書へ変換します

flatフィールドに1つのJSONオブジェクトをご指定ください。有効なJSON値を使い、プロパティ名は引用符で囲んでください。

データを失う前に競合パスを検出します

userが文字列であり、同時にuser.nameも存在する入力は、1つのJSON構造で両方を表せません。この機能は最後に処理した値を勝手に採用せず、invalid_inputとして拒否します。

移行処理やアプリケーションの流れで活用できます

この変換は境界形式を読み取った直後、ネストJSONスキーマで検証する前に配置してください。ブラウザーは手軽な確認に適し、自動化には$0.002からのAPIをご利用いただけます。値は文字列解析や型推論なしでコピーされるので、JSONを意図的に格納した文字列は送信前に解析してください。

照会の別名を復元

customer.nameやcustomer.address.cityの列を、APIが求めるネストされたcustomerオブジェクトへ変換します。

設定を検証前に整形

JSONスキーマや既定値を適用する前に、フラットキーからネスト設定を復元します。

フォームとイベントを正規化

フォーム、ログ、分析出力のドット付き項目名を、後続処理用の通常JSONへ変換します。

料金はいくらですか?

APIは1項目あたり$0.002からです。このページのブラウザーでも変換を実行できます。

一方のキーが他方の接頭辞ならどうなりますか?

接頭辞がオブジェクト以外の値なら、2つのパスは共存できないためinvalid_inputになります。

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