ForHosting KIT · サイト取得・監視

JSON構文チェック

JSON文字列を貼り付けるか送信すると、元の内容を変更、整形、修復せずに構文が正しいか確認できます。検証結果は常に構造化されます。正しい入力では単純な真のフラグを返し、正しくない入力では偽のフラグに加えて、パーサーのメッセージと解析が停止した位置、行、列を返します。この予測可能な応答は、エディター、アップロードフォーム、デプロイ前の確認、テストスイートなど、処理を停止させずに不正なJSON文書の問題を説明する必要がある場面で役立ちます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

文書を変更せずに構文を確認できます

構文検証では、標準に準拠したパーサーが与えられた文字列をそのまま読み取れるか、という明確な問いに答える必要があります。このツールは入力されたテキストをプラットフォームのJSONパーサーへ直接渡します。前後の空白削除、引用符の置換、コメントの削除、コンマの挿入、キーの並べ替え、値の再解釈は行いません。この方針は設定ファイルやAPIペイロードを試す際に重要です。自動修正を行うと、本番環境では残る不具合を隠してしまう可能性があるためです。有効という結果は、オブジェクト、配列、文字列、数値、真偽値、nullを含む文字列全体が、1つのJSON値として受理されたことを示します。構文が不正な場合も例外にはせず、通常の結果として返します。そのため、応答をすぐに表示したり、コードで有効フラグを判定したりできます。空のテキスト、余分な後続内容、コメント、単一引用符の文字列、末尾のコンマ、エスケープされていない制御文字はJSON構文ではないため無効です。

報告されたエラー位置を解釈できます

解析に失敗すると、メッセージと3つの座標を持つエラーオブジェクトが返ります。positionはJavaScript文字列の先頭から数える0始まりの文字オフセットです。lineとcolumnは1始まりなので、エディターや検証メッセージに表示しやすくなっています。改行のたびに行番号が増え、列番号は1に戻ります。示される場所はパーサーが処理を続行できないと判断した地点であり、実際の入力ミスはその直前にある場合があります。たとえば、2つのプロパティ間のコンマが欠けていると、2つ目のプロパティを開始する引用符で報告されることがあります。そこで初めて、先行する値の後に正しい文字がないと判断できるためです。未完了のオブジェクトや配列はテキスト末尾で報告されます。メッセージ表現はJavaScript実行環境によって異なる場合があります。移動には数値フィールドを使用し、メッセージは利用者向けに表示してください。全文を固定的な機械判定カテゴリとして照合することは推奨されません。

フォームや自動チェックで安全に利用できます

ブラウザーのフォームでは、設定を送信する前に検証を実行し、結果が偽なら返された位置へカーソルを移動できます。API処理では応答をデータとして扱い、有効な場合だけ続行してください。無効な場合は行、列、メッセージをビルドレポート、サポート依頼、拒否したアップロードなどへ添付できます。不正なJSONは想定される利用者入力なので、入力エラーでタスクを失敗させず、有効フラグが偽の正常な結果として返します。必須のtextフィールドがない場合、または文字列でない場合だけ、調査するJSONソースが存在しないためリクエストを拒否します。アルゴリズムは決定論的で、ネットワーク、モデル、乱数、時刻、永続状態を使用しません。通常の解析と位置計算に要する時間は文書サイズに対して線形に増加します。APIは1リクエスト$0.002で、ブラウザー版では同じ確認をローカルで実行できます。

活用例

デプロイ前に設定を検証します

JSON設定にコンマの欠落、対応しない括弧、不正なエスケープなどの構文問題があれば、リリースを停止できます。

エディターで正確な場所を案内します

返されたオフセット、行、列を使い、解析に失敗した地点まで利用者を案内できます。

不正なAPIペイロード例を拒否します

取得または生成したJSON文字列を、パーサー例外でテスト実行を中断せずに確認できます。

よくある質問

JSON構文検証では何が返されますか？

有効なJSONではvalidがtrueのオブジェクトを返します。無効な場合はvalidがfalseとなり、メッセージ、0始まりの位置、1始まりの行と列を返します。

無効なJSONを修復または整形しますか？

いいえ。元の文字列をそのまま検証し、文書を変更せずに解析エラーを報告します。

コメントや末尾のコンマを使用できますか？

いいえ。標準JSONではコメントも末尾のコンマも許可されず、構文エラーとして報告されます。

プリミティブ値だけでも有効なJSONですか？

はい。最上位の値にはオブジェクト、配列、文字列、数値、真偽値、nullを使用できます。

APIでの検証料金はいくらですか？

APIは1リクエスト$0.002です。ブラウザーの対話型ツールでは、同じ決定論的な検証をローカルで実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/web/json-validate

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

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/web/json-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"{\"name\":\"Ada\",\"active\":true}"}'

const res = await fetch("https://api.kit.forhosting.com/web/json-validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "{\"name\":\"Ada\",\"active\":true}"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/json-validate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "{\"name\":\"Ada\",\"active\":true}"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/json-validate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"{\\"name\\":\\"Ada\\",\\"active\\":true}"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"{\"name\":\"Ada\",\"active\":true}"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/json-validate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "text": "{\"name\":\"Ada\",\"active\":true}"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.json_validate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

料金

1リクエストあたり$0.002

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

制限

`timeout_sec`	30
`max_crawl_pages`	25

エラー

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

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