ForHosting KIT · 開発者向けツール

データ範囲計算

データ範囲計算ツールは、数値データに含まれる最小値と最大値の間の広がりを測定します。空でない数値配列を指定すると、要素数、最小値、最大値、および最大値から最小値を引いた範囲を返します。処理は決定的であり、負数や小数をそのまま扱います。空の配列や有限数ではない値は受け付けません。簡潔な記述統計、検証規則、または再現可能なデータ処理の構成要素としてご利用いただけます。

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

無料で実行 API仕様を見る

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

範囲からデータについて分かること

範囲は、統計的な散らばりを表す最も簡単な指標の一つです。最小の観測値と最大の観測値がどれだけ離れているかという問いに直接答えます。本ツールは指定されたすべての数値を調べ、最小値と最大値を特定し、最大値から最小値を引きます。4、7、12、15、19の場合、最小値は4、最大値は19、範囲は15です。値が一つだけのデータでは、最小値と最大値が同じなので範囲はゼロです。負数にも特別な処理は不要です。最小値が-8、最大値が3なら、範囲は11になります。有効な有限数を入力した場合、結果が負になることはありません。この指標は規模をすばやく把握するのに役立ちますが、説明するのは両端だけです。中間の値の分布、値の集中、極端な観測値の影響までは分かりません。内部の分布が重要な場合は、中央値、四分位数、標準偏差などと併せてご利用ください。

数値配列の準備と検証方法

numbersフィールドには、有限数を少なくとも一つ含むJSON配列として観測値を指定してください。整数、小数、ゼロ、負数を使用でき、元の並び順は結果に影響しません。数値に見える文字列は意図的に無効として扱います。JSON値の"12"は文字列であり、12は数値です。表計算から取り込んだセルやフォーム項目は、送信前に変換してください。意図しないラベル、空文字列、null、形式が不正な測定値が計算へ密かに混入するのを防げます。無限値とNaNも、有限で移植可能なJSON結果を生成できないため拒否されます。検証に成功すると、要素数、最小値、最大値、範囲が返され、計算根拠を確認できます。最小値と最大値は差を生んだ端点を示し、要素数は調査した観測値の数を示します。配列が空の場合や数値以外の要素がある場合は、不完全な統計値ではなく無効入力エラーを返します。

分析と自動化での結果の活用方法

データ範囲は、簡潔なスクリーニング指標として役立ちます。品質管理では、反復測定の範囲を許容差と比較し、散らばりが大きすぎるロットを検出できます。応答時間を監視するアプリケーションでは、最速と最遅の観測値の日次差を追跡できます。教員や学習者は、答えの根拠となる端点を確認しながら入門的な統計問題を検算できます。APIワークフローでは、返された最小値、最大値、範囲、要素数を元のバッチとともに保存すると、後から結論を再現できます。範囲は外れ値の影響を強く受ける点にご注意ください。他の値が安定していても、誤ったセンサー値一つが統計を左右することがあります。その影響が望ましくない場合は、元データを確認し、四分位数に基づく指標も併用してください。本ツールは配列を決定的に一度走査し、ネットワーク、乱数、時刻を使用しません。APIリクエストは1回 $0.002 で、ブラウザー版と同じ規則を適用します。

活用例

測定値の散らばりを確認

最小測定値と最大測定値の差を、品質管理で許容される公差と比較します。

得点群を要約

評価、調査、競技で観測された得点の広がりを両端の値とともに報告します。

取り込みデータを検証

後続処理で範囲を使用する前に、空または不正値を含む数値配列を拒否します。

よくある質問

データ範囲はどのように計算しますか？

最小値を最大値から引きます。式は、範囲 = 最大値 - 最小値です。

配列に負数や小数を含められますか？

はい。負数、ゼロ、整数、小数を含む有限のJSON数値を使用できます。

配列が空の場合はどうなりますか？

空のデータでは最小値と最大値を定義できないため、無効入力エラーを返します。

数値を表す文字列は使用できますか？

いいえ。"12"は文字列なので拒否されます。JSON数値の12を指定してください。

APIリクエストの料金はいくらですか？

APIリクエストは1回 $0.002 です。同じ決定的な計算をブラウザーでも実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/stat/data-range

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

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

curl -X POST https://api.kit.forhosting.com/stat/data-range \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers":[12,7,19,4,15]}'

const res = await fetch("https://api.kit.forhosting.com/stat/data-range", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "numbers": [
      12,
      7,
      19,
      4,
      15
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/data-range",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "numbers": [
        12,
        7,
        19,
        4,
        15
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/data-range", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"numbers":[12,7,19,4,15]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"numbers":[12,7,19,4,15]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/data-range", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "numbers": [
    12,
    7,
    19,
    4,
    15
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

エラー

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

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