CSVをカラムスキーマで検証し行と型のエラーを特定
CSVファイルは整って見えても、インポートやレポート、データ処理を停止させる値が含まれている場合があります。この検証ツールは、ヘッダーを想定した列と厳密に比較し、文字列、数値、整数、真偽値、ISO日付の明確な規則で全データ行を調べます。最初の誤りで停止せず、CSVの行番号と列名を添えて違反をすべて返します。ブラウザーでは無料で実行でき、自動処理では1リクエスト当たり$0.002でAPIをご利用いただけます。
無料で実行
処理はブラウザ内で完結します。ファイルは送信されません。無料でご利用いただけます。
ファイルを確認する前に契約を定義します
想定する各列について、正確な名前、型、必須かどうかの3項目をご指定ください。CSVは位置で値を表すため、列順も重要です。name,idとid,nameは同じ名前を含んでいても、安全に同一とは扱えません。そのため、本ツールはデータ行を調べる前に、ヘッダー全体をスキーマと比較します。列の不足、追加、改名、重複、並べ替えがある場合は、誤解を招く検証結果ではなく入力エラーを返します。対応する型はstring、number、integer、boolean、dateです。数値は通常の小数表記と科学表記に対応し、整数は安全な整数である必要があります。真偽値は大文字と小文字を区別せずtrueまたはfalseを受け付けます。日付はYYYY-MM-DD形式で、実在する暦日かどうかも確認します。stringは空でない文字列を受け付け、requiredは空欄を許すかどうかを別に決めます。任意の整数列は空欄にできますが、値がある場合は正しい整数でなければなりません。
行と列の違反を正確に読み取れます
結果にはまずvalidと、確認した行数、列数、違反数の集計が表示されます。validがfalseの場合、violations配列に各問題の行番号、列名、安定したコード、読みやすいメッセージが入ります。行番号はCSVそのものに合わせており、行1がヘッダー、最初のレコードが行2です。したがって、元ファイルを開いて報告された場所へ直接移動できます。required違反は必須セルが空であることを示し、type違反は空でない値が宣言された型に合わないことを示します。フィールド数が多すぎる、または少なすぎる行には、特定のセルへ安全に帰属できない構造上の問題として、特別な列_rowにcolumn_count違反を付けます。引用符内のコンマ、エスケープされた引用符、埋め込み改行、CRLF形式をCSV構文として解析するため、正しい引用フィールドによって後続列がずれることはありません。
ワークフローの入口で検証します
ファイルがシステムへ入る地点のできるだけ近くで検証してください。取引先のアップロードをデータベースへ到達する前に拒否したり、定期エクスポートを後続計算の前に確認したり、インポート画面で修正可能なセルをまとめて提示したりできます。アルゴリズムは決定的でネットワークを使わないため、同じCSVとスキーマからは常に同じレポートが得られます。自動ゲートにも対話的な修正にも適しています。ヘッダー不一致と行違反は分けてお考えください。前者はファイルが想定したデータセットではないことを示し、後者は認識できるレコードに修正が必要なことを示します。本ツールは問題を報告するだけで、値の編集、型変換、空白除去、置換は行いません。識別子や先頭のゼロ、人が入力した文章を暗黙に変える心配がありません。正規化が必要な場合は独立した工程として明示的に実行し、出力先が本当に求める契約に対して再検証してください。
活用例
インポート時の品質ゲート
顧客や取引先のCSVをデータベースへ取り込む前に、正確な行と列の指摘を添えて不備のあるファイルを拒否できます。
定期エクスポートの監視
ヘッダーの変更、必須セルの欠落、宣言した型に合わなくなった値を定期的なエクスポートから検出します。
一括修正の支援
検出できる違反を一度に返し、担当者が1回の確認でファイルを修正できるようにします。
よくある質問
CSVヘッダーはスキーマと同じ順序である必要がありますか?
はい。名前と順序が完全に一致しない場合、ヘッダーに関する入力エラーとしてリクエストが失敗します。
どの列型に対応していますか?
string、number、integer、boolean、dateに対応します。日付はYYYY-MM-DD形式の実在する暦日である必要があります。
最初の不正な行で検証は停止しますか?
いいえ。ヘッダーが合格した後は全データ行を確認し、検出した違反をまとめて返します。
引用符内のコンマや改行はどのように扱われますか?
引用フィールドにはコンマ、エスケープした二重引用符、改行を含めることができ、余分な列として分割されません。
CSVの値を変更したり型変換したりしますか?
いいえ。違反の報告だけを行い、送信されたCSVの空白除去、変換、補完、書き換えは一切行いません。
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/data/csv-validate-schema \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"csv":"id,email,active\n1,ada@example.com,true\n2,grace@example.com,false","schema":[{"name":"id","type":"integer","required":true},{"name":"email","type":"string","required":true},{"name":"active","type":"boolean","required":true}]}'const res = await fetch("https://api.kit.forhosting.com/data/csv-validate-schema", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"csv": "id,email,active\n1,ada@example.com,true\n2,grace@example.com,false",
"schema": [
{
"name": "id",
"type": "integer",
"required": true
},
{
"name": "email",
"type": "string",
"required": true
},
{
"name": "active",
"type": "boolean",
"required": true
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/data/csv-validate-schema",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"csv": "id,email,active\n1,ada@example.com,true\n2,grace@example.com,false",
"schema": [
{
"name": "id",
"type": "integer",
"required": true
},
{
"name": "email",
"type": "string",
"required": true
},
{
"name": "active",
"type": "boolean",
"required": true
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/csv-validate-schema", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"csv":"id,email,active\\n1,ada@example.com,true\\n2,grace@example.com,false","schema":[{"name":"id","type":"integer","required":true},{"name":"email","type":"string","required":true},{"name":"active","type":"boolean","required":true}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"csv":"id,email,active\n1,ada@example.com,true\n2,grace@example.com,false","schema":[{"name":"id","type":"integer","required":true},{"name":"email","type":"string","required":true},{"name":"active","type":"boolean","required":true}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/csv-validate-schema", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"csv": "id,email,active\n1,ada@example.com,true\n2,grace@example.com,false",
"schema": [
{
"name": "id",
"type": "integer",
"required": true
},
{
"name": "email",
"type": "string",
"required": true
},
{
"name": "active",
"type": "boolean",
"required": true
}
]
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "data.csv_validate_schema",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_mb | 25 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |