ForHosting KIT · 開発者向けツール

逆パーセント計算機

最終的な価格、残高、測定値、合計だけでは、変化前の状態が分からないことがあります。この逆パーセント計算機は、最終金額、割合、その割合が加算されたか差し引かれたかを基に、元の金額を復元します。最終値から割合を単純に引くのではなく、正しい逆倍率を使用します。復元した元の金額、変化額の絶対値、使用した倍率が結果に含まれるため、計算内容を確認し、説明し、自動処理に組み込むことができます。

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

無料で実行 API仕様を見る

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

割合の逆算で割り算が必要な理由

割合による変化は、最終金額ではなく元の金額を基準に計算されます。そのため、変化を逆算するには割り算が必要です。元の値が20パーセント増加した場合、最終値は元の120パーセント、つまり元の値に1.20を掛けた値です。したがって、出発点を求めるには最終金額を1.20で割ります。最終金額の20パーセントを引く方法では基準が異なるため、正しい答えになりません。減少の場合も同じです。20パーセントを差し引いた後には元の80パーセントが残るので、最終金額を0.80で割ります。割合が加算されたか差し引かれたかを選び、通常のパーセント値と確認済みの最終金額を入力してください。計算機は元の金額に加えて正確な倍率と式を表示しますので、結果がどのように得られたかを明確に確認できます。

加算と差し引きを正しく選ぶ方法

操作の選択肢は、不明な元の金額に何が起きたかを示します。値上げ、昇給、成長、割増などによって最終金額になった場合は、加算を選択してください。割引、減額、損失、縮小などによる場合は、差し引きを選択します。加算時の除数は、1に割合の小数表現を足した値です。差し引き時は、1からその小数を引いた値になります。差し引く割合は100パーセント未満でなければなりません。ちょうど100パーセントを差し引くと、どのような開始額でも結果はゼロになり、最終値だけから元の金額を一意に復元できないためです。0パーセントはどちらの操作でも有効で、金額は変わりません。単位も統一してください。最終値が円、キログラム、販売個数のいずれであっても、元の値と変化額には同じ単位が使われます。12.5パーセントは0.125ではなく12.5と入力してください。

結果の読み方、丸め方、活用方法

元の金額は、指定された変化が起きる前の復元値です。変化額は元の金額と最終金額の差の絶対値なので、加算でも差し引きでも正の値になります。倍率は、元の値のどの割合が最終値になったかを示します。たとえば15パーセントの加算後は1.15、15パーセントの差し引き後は0.85です。数値項目は既定で小数点以下10桁に丸められますが、表示や後続処理に合わせて0桁から15桁まで指定できます。丸めは表示結果だけに適用され、計算自体には利用可能な数値精度が使われます。金額では2桁が便利な場合がありますが、中間計算の照合や独自の通貨丸め規則が必要な場合は、より多くの桁を保持してください。この処理は決定的でネットワーク要求を行わないため、同じ入力からは常に同じ結果が得られます。ブラウザーでの確認、表計算の代替、反復可能な業務処理、API の検証に適しています。

活用例

価格の上乗せを逆算

表示価格に既知の上乗せ率が含まれる場合に、卸売価格または基本価格を復元します。

割引前の金額を算出

割引後の最終値と差し引かれた割合から、元の表示金額を計算します。

以前の残高を復元

既知の割合で増減した現在残高から、変化前の値を逆算します。

よくある質問

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

API リクエストは1回 $0.002 です。ブラウザーでは計算機を無料でご利用いただけます。

最終金額から割合を引くだけではいけないのですか？

割合は元の金額に適用されており、最終金額とは基準が異なります。変化倍率で割ることで正しく逆算できます。

割合による増加を逆算するにはどうしますか？

加算を選択してください。最終金額を、1に割合を100で割った値を加えた数で割ります。

割合による減少を逆算するにはどうしますか？

差し引きを選択してください。最終金額を、1から割合を100で割った値を引いた数で割ります。

差し引く割合が100未満である必要があるのはなぜですか？

100パーセントではどの元の値でも最終値がゼロになり、元の金額を一意に復元できないためです。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/fin/reverse-percentage

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

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

curl -X POST https://api.kit.forhosting.com/fin/reverse-percentage \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"final_amount":120,"percentage":20,"operation":"added"}'

const res = await fetch("https://api.kit.forhosting.com/fin/reverse-percentage", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "final_amount": 120,
    "percentage": 20,
    "operation": "added"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/reverse-percentage",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "final_amount": 120,
    "percentage": 20,
    "operation": "added"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/reverse-percentage", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"final_amount":120,"percentage":20,"operation":"added"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"final_amount":120,"percentage":20,"operation":"added"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/reverse-percentage", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "final_amount": 120,
  "percentage": 20,
  "operation": "added"
}

レスポンス例

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