ForHosting KIT · 開発者向けツール

マイル価値計算ツール

この計算ツールは、特典の現金相当価格を1マイル当たりの価値に換算し、複数の交換先を比べやすくします。必要マイル数、実際に支払ってもよい現金価格、任意の基準値をご入力ください。計算値、目標との差、簡潔な評価が表示され、航空券、アップグレード、ホテルなどの特典判断にご利用いただけます。

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

無料で実行 API仕様を見る

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

特典価格を比較できる数値に換算します

必要マイル数だけを見ても、特典がお得かどうかは判断できません。同じ25.000マイルでも、直前の高額な航空券に使う場合と、現金価格が安い座席に使う場合では、得られる価値が大きく異なります。このツールは現金相当価格を必要マイル数で割り、1マイル当たりの価値をセントで示します。これにより、路線、座席クラス、日程、プログラムが異なる特典も共通の尺度で比較できます。入力する価格には、実際にお客様が支払ってもよい金額をお使いください。購入する予定のない高額な変更可能運賃を使うと、価値が過大に見えます。現金価格425、必要マイル25.000なら、各マイルが置き換える現金価値を求めます。特典利用時にも現金で払う税金や手数料は、通常、比較する価格から差し引いてください。マイルが負担しない金額を除くことで、高額な追加料金のある特典を実態以上に評価せず、公平に比べられます。

基準値を選び、結果を読み取ります

基準値は、マイルを使う際に最低限得たい価値です。初期値は一般的な目安ですが、すべてのお客様やプログラムに当てはまる唯一の相場はありません。普段得られる交換価値、追加マイルの購入費、貯めやすさ、制度変更による価値低下の可能性を踏まえて、ご自身の基準を設定できます。結果が基準未満なら基準未達、基準以上なら良好、基準の150%以上なら非常に良好と判定します。この評価は入力値同士の関係だけを表す機械的なものであり、旅行そのものの品質を保証しません。現金を残したい場合、希少な空席を確保できる場合、または失効直前のマイルを使う場合は、基準を少し下回っても合理的です。反対に、入力した現金運賃を実際には決して購入しないのであれば、非常に高い評価にも意味がありません。結果は判断材料としてお使いいただき、お客様の事情に代わる絶対的な規則にはしないでください。

同じ条件で複数の特典を比較します

有効な比較には、すべての候補へ同じ前提を適用してください。同一通貨を使い、似た運賃条件を一貫して評価し、避けられない税金や予約手数料を現金相当額から差し引きます。エコノミーとビジネスを比べるときは、上位クラスの販売価格がお客様にとって本当の価値を持つかをご検討ください。定価全額を使うと、実際には支払わない金額でも非常に高い結果が出ることがあります。払い戻し可能運賃、許容できる最安の代替案、ご自身が支払ってもよい上限などで複数回計算すると、判断の幅が分かります。割合の差は基準よりどれだけ上または下かを示し、良好な候補同士の順位付けにも便利です。本ツールが評価するのは交換価値だけです。移行ボーナス、有償航空券で得るポイント、上級会員特典、取消条件、空席状況、将来の価値低下は含みません。最終判断ではそれらも重要ですが、透明な計算により中心となる交換条件を明確に保てます。

活用例

現金払いと特典を比較

支払うかマイルを使うか決める前に、特典価格を1マイル当たりの価値へ換算できます。

複数の旅行特典を順位付け

路線、日程、座席クラスを同じ基準で評価し、より価値の高い候補を確認できます。

交換方針を設定

個人の最低基準を使い、マイルを貯める場合と使う場合を一貫して判断できます。

よくある質問

1マイル当たりの価値はどのように計算しますか？

現金相当価格をセントに直すため100を掛け、必要マイル数で割ります。

特典の税金や手数料を含めますか？

マイルでは補えないため、現金で支払う税金や手数料は比較対象の価格から差し引いてください。

どの基準値を使えばよいですか？

プログラム、獲得費用、普段の交換機会、お客様の旅行方針に合う値をご指定ください。

良好なら必ず交換すべきですか？

いいえ。基準との比較にすぎず、空席、柔軟性、快適性、予算も考慮する必要があります。

ホテルやアップグレードにも使えますか？

はい。必要マイル数と現実的な現金相当価格が分かる特典なら比較できます。

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

APIの各リクエスト料金は$0.002です。同じ確定的な計算をブラウザでも実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/travel2/frequent-flyer-miles-value

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

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

curl -X POST https://api.kit.forhosting.com/travel2/frequent-flyer-miles-value \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"miles":25000,"cash_value":425}'

const res = await fetch("https://api.kit.forhosting.com/travel2/frequent-flyer-miles-value", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "miles": 25000,
    "cash_value": 425
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel2/frequent-flyer-miles-value",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "miles": 25000,
    "cash_value": 425
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel2/frequent-flyer-miles-value", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"miles":25000,"cash_value":425}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"miles":25000,"cash_value":425}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel2/frequent-flyer-miles-value", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "miles": 25000,
  "cash_value": 425
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel2.frequent_flyer_miles_value",
  "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の完全なドキュメントを見る →