ForHosting KIT · 開発者向けツール

SLA稼働率からサービスクレジットを計算

この計算ツールは、測定済みの月間稼働率を明確なサービスクレジット額に換算します。稼働率、対象となる月額請求額、契約書のクレジット表をご入力ください。該当範囲と率を特定し、支払われるクレジットと適用後の残額を返します。提供者とお客様の双方が、調整内容と締結済みSLAとの整合性を確認する際に役立ちます。

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

無料で実行 API仕様を見る

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

SLA表を明確な範囲として入力します

販促資料の要約ではなく、署名済み契約書のサービスクレジット表をご参照ください。各階層について、稼働率の下限、上限、クレジット率をご入力ください。下限は範囲に含み、上限は含みません。ただし上限が100の場合は100も含みます。この規則により、隣接範囲を明確につなげられます。たとえば99から99.9までの階層は99以上99.9未満を対象とし、次の階層は99.9ちょうどから始まります。範囲を重複させないでください。契約に実際の空白があれば残せますが、その空白に入る測定値はエラーになります。必要ならクレジット率ゼロの範囲も追加してください。すべての境界値と率はゼロから100までとし、下限は上限より小さくする必要があります。

正しい稼働率と対象請求額を使用します

SLAの対象サービスおよび期間について確定した月間稼働率をご使用ください。告知済み保守、お客様に起因する停止、影響地域外のサービスなどが除外される場合があるため、入力値には契約の測定規則をあらかじめ反映させます。月額請求額もクレジット対象分に限定してください。契約によっては請求書全体ではなく、影響を受けたサービスや継続料金だけが対象です。通貨は任意ですが、ゼロ以上の金額をご入力ください。本ツールは通貨の判定や換算を行いません。対象額に該当階層の率を掛け、金額を小数第2位までに丸めます。結果には入力値、階層、クレジット額、適用後残額が表示されます。利用前に元資料の値をご確認ください。

結果を確認して請求記録を残します

選択された階層を契約書の正確な文言と照合してください。結果には上限を含むかどうかも表示されるため、99.9や100などの境界値を確認できます。監視レポート、SLA表、対象料金の算定根拠、算出クレジットを申請または承認記録に添付すると、別の担当者も同じ入力で結果を再現できます。このアルゴリズムはネットワーク、現在日時、乱数、外部データを使用しません。ゼロから100の範囲外の稼働率、不正な請求額、不完全または重複した階層、どの階層にも属さない測定値は拒否します。これは推測による誤算を防ぐためです。APIは1回$0.002で、ブラウザーでは手早く手動確認できます。本結果は計算支援であり、申請期限、上限額、手続き、その他の契約条件に優先するものではありません。

活用例

お客様向けクレジットの検証

調整額がSLA所定の稼働率、対象料金、クレジット率に基づくかをご確認いただけます。

停止に伴う申請の準備

申請前に金額を算出し、該当階層と監視証拠を一緒に保存できます。

請求調整の自動化

管理されたSLA表を月次結果に適用し、算出額を確認フローへ渡せます。

よくある質問

サービスクレジットはどのように算出されますか？

対象月額に、測定稼働率を含む唯一の階層の率を掛け、小数第2位までに丸めます。

稼働率がゼロ未満または100を超える場合はどうなりますか？

ゼロから100の範囲外は有効な割合ではないため、入力エラーを返します。

階層の境界はどのように扱われますか？

下限は含み、上限は含みません。ただし上限100だけは100ちょうどを含みます。

測定値を含む階層がない場合はどうなりますか？

エラーを返します。契約上不足している範囲を追加するか、測定値を修正してください。

請求書の全額を入力できますか？

SLAで認められる場合に限ります。影響サービスや継続料金だけが対象となる契約も多くあります。

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

APIリクエスト1回につき$0.002です。結果にはクレジット額と適用後残額が含まれます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/dev/server-uptime-sla-credit-calc

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

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

curl -X POST https://api.kit.forhosting.com/dev/server-uptime-sla-credit-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"uptime_percentage":99.5,"monthly_bill":2500,"sla_tiers":[{"minimum_uptime":0,"maximum_uptime":99,"credit_percentage":25},{"minimum_uptime":99,"maximum_uptime":99.9,"credit_percentage":10},{"minimum_uptime":99.9,"maximum_uptime":100,"credit_percentage":0}]}'

const res = await fetch("https://api.kit.forhosting.com/dev/server-uptime-sla-credit-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "uptime_percentage": 99.5,
    "monthly_bill": 2500,
    "sla_tiers": [
      {
        "minimum_uptime": 0,
        "maximum_uptime": 99,
        "credit_percentage": 25
      },
      {
        "minimum_uptime": 99,
        "maximum_uptime": 99.9,
        "credit_percentage": 10
      },
      {
        "minimum_uptime": 99.9,
        "maximum_uptime": 100,
        "credit_percentage": 0
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/server-uptime-sla-credit-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "uptime_percentage": 99.5,
    "monthly_bill": 2500,
    "sla_tiers": [
        {
            "minimum_uptime": 0,
            "maximum_uptime": 99,
            "credit_percentage": 25
        },
        {
            "minimum_uptime": 99,
            "maximum_uptime": 99.9,
            "credit_percentage": 10
        },
        {
            "minimum_uptime": 99.9,
            "maximum_uptime": 100,
            "credit_percentage": 0
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/server-uptime-sla-credit-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"uptime_percentage":99.5,"monthly_bill":2500,"sla_tiers":[{"minimum_uptime":0,"maximum_uptime":99,"credit_percentage":25},{"minimum_uptime":99,"maximum_uptime":99.9,"credit_percentage":10},{"minimum_uptime":99.9,"maximum_uptime":100,"credit_percentage":0}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"uptime_percentage":99.5,"monthly_bill":2500,"sla_tiers":[{"minimum_uptime":0,"maximum_uptime":99,"credit_percentage":25},{"minimum_uptime":99,"maximum_uptime":99.9,"credit_percentage":10},{"minimum_uptime":99.9,"maximum_uptime":100,"credit_percentage":0}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/server-uptime-sla-credit-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "uptime_percentage": 99.5,
  "monthly_bill": 2500,
  "sla_tiers": [
    {
      "minimum_uptime": 0,
      "maximum_uptime": 99,
      "credit_percentage": 25
    },
    {
      "minimum_uptime": 99,
      "maximum_uptime": 99.9,
      "credit_percentage": 10
    },
    {
      "minimum_uptime": 99.9,
      "maximum_uptime": 100,
      "credit_percentage": 0
    }
  ]
}

レスポンス例

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