ForHosting KIT · 開発者向けツール

複数製品の保証期限と間近の期限を計算

この保証期限管理ツールは、購入記録を実用的な期限一覧にまとめます。各品目の名称、購入日、月単位の保証期間を入力し、基準日と通知対象の日数を指定してください。計算した保証期限、残り日数、すでに期限切れかどうか、有効な保証が指定期間内に終了するかどうかを品目ごとに表示します。暦月に基づいて短い月やうるう年も一貫して扱うため、家庭の記録、社内機器台帳、調達業務、サポート計画にご利用いただけます。

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

無料で実行 API仕様を見る

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

購入品と保証の明確な台帳をご用意ください

管理する製品ごとに1件の記録をご用意ください。各記録には、識別しやすい名称、YYYY-MM-DD形式の購入日、暦月単位の整数による保証期間が必要です。「事務用ノートPC」のような名称でも構いませんが、同種の製品が多い場合は、資産番号、注文番号、シリアル番号を含む識別名の方が便利です。保証が実際に始まる請求書または証明書の日付をお使いください。規約で納品時から開始すると定められていない限り、購入日を納品日に置き換えないでください。保証期限を購入日と同日にする必要がある場合は0か月を指定できます。負の期間は将来に向かう有効な保証を表さないため、エラーになります。後日の問い合わせに備え、請求書と保証規約を台帳とともに保管することをおすすめします。結果は入力順のまま返されるため、部門、設置場所、担当者、優先度などであらかじめ並べられます。1回のリクエストで最大1000件を処理でき、無制限の入力を許すことなく大規模な機器台帳にも対応します。

暦月による期限計算の仕組みをご確認ください

保証期間は30日を1単位とする固定日数ではなく、暦月として購入日に加算されます。月の日数は28日から31日まで異なり、うるう年には2月29日があるため、この違いは重要です。まず対象の年と月へ進み、元の日が存在すれば同じ日を採用します。存在しない場合は、対象月の最終有効日へ調整します。たとえば1月31日の購入品に1か月の保証を付けると、平年は2月28日、うるう年は2月29日が期限です。2月29日の購入品に12か月の保証を付けると、翌年2月28日が期限になります。この規則は決定的で、ブラウザーのタイムゾーンに左右されず、一部の日付ライブラリで起きる予想外の翌月繰り越しも避けられます。表示される期限は、入力された購入日と期間から算出した基準日です。実際の契約では、期限日の終了時刻まで有効、製品登録が必須、発送日から開始、特別延長があるなどの条件も考えられます。必ず販売店またはメーカーの保証規約と照合してください。

通知期間を使って対応の優先順位を付けてください

台帳を確認する起点の日を基準日として指定してください。基準日を明示することで、翌日や別のタイムゾーン、後日の監査でも同じ入力から同じ結果を再現できます。残り日数は、期限が将来なら正、基準日に期限を迎える場合は0、すでに過ぎていれば負です。有効な保証の残り日数が0以上で、選択した上限以下の場合にだけ、指定期間内の期限として表示します。期限切れの製品は明確に表示しますが、今後対応すべき製品には含めません。通常の月次確認には30日程度が便利です。点検、販売店への連絡、返品承認、代替品の予算化などに時間が必要な場合は、より長い期間をご指定ください。同じ台帳を新しい基準日で定期的に実行するほか、調達ダッシュボードから自動化することもできます。API の料金は1リクエスト $0.002 です。この表示は書類確認と対応開始の目安であり、保証契約そのものの代わりではありません。基準日とともに結果を保存すると、各製品をいつ、なぜ優先したのかを関係者が確認できます。

活用例

オフィス機器の保証状況を確認

ノートPC、モニター、プリンター、周辺機器の期限を計算し、次回の月次確認までに対応が必要な有効保証を把握できます。

家庭用品の申請と買い替えを計画

家電や電子機器を一覧にまとめ、保証終了前にレシートとサポートの選択肢を確認できます。

調達業務と資産監査を支援

基準日、残り日数、期限切れ状態、期限接近の統一表示を含む再現可能な記録を作成できます。

よくある質問

保証期限はどのように計算しますか？

購入日に暦月単位の整数期間を加えます。対象月に元の日がなければ、その月の最終有効日を使用します。

保証期間が負の場合はどうなりますか？

負の期間は将来の保証を表せないため、無効な入力としてリクエストがエラーになります。

期限切れの保証も期限接近として扱いますか？

いいえ。期限切れと表示し、残り日数は負になりますが、今後の通知期間の対象にはしません。

通知期間の両端の日も対象ですか？

はい。基準日に期限を迎える有効保証と、選択した日数後ちょうどに期限を迎える保証を含みます。

基準日を入力するのはなぜですか？

現在時刻に依存せず、過去または将来のレポートを同じ条件で再現できる決定的な計算にするためです。

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

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

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/final3/warranty-expiration-tracker

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

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

curl -X POST https://api.kit.forhosting.com/final3/warranty-expiration-tracker \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchases":[{"name":"Laptop","purchase_date":"2024-02-29","warranty_months":24},{"name":"Headphones","purchase_date":"2025-08-15","warranty_months":12}],"reference_date":"2026-07-31","within_days":30}'

const res = await fetch("https://api.kit.forhosting.com/final3/warranty-expiration-tracker", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "purchases": [
      {
        "name": "Laptop",
        "purchase_date": "2024-02-29",
        "warranty_months": 24
      },
      {
        "name": "Headphones",
        "purchase_date": "2025-08-15",
        "warranty_months": 12
      }
    ],
    "reference_date": "2026-07-31",
    "within_days": 30
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/warranty-expiration-tracker",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "purchases": [
        {
            "name": "Laptop",
            "purchase_date": "2024-02-29",
            "warranty_months": 24
        },
        {
            "name": "Headphones",
            "purchase_date": "2025-08-15",
            "warranty_months": 12
        }
    ],
    "reference_date": "2026-07-31",
    "within_days": 30
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/warranty-expiration-tracker", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"purchases":[{"name":"Laptop","purchase_date":"2024-02-29","warranty_months":24},{"name":"Headphones","purchase_date":"2025-08-15","warranty_months":12}],"reference_date":"2026-07-31","within_days":30}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"purchases":[{"name":"Laptop","purchase_date":"2024-02-29","warranty_months":24},{"name":"Headphones","purchase_date":"2025-08-15","warranty_months":12}],"reference_date":"2026-07-31","within_days":30}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/warranty-expiration-tracker", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "purchases": [
    {
      "name": "Laptop",
      "purchase_date": "2024-02-29",
      "warranty_months": 24
    },
    {
      "name": "Headphones",
      "purchase_date": "2025-08-15",
      "warranty_months": 12
    }
  ],
  "reference_date": "2026-07-31",
  "within_days": 30
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_items 1000

エラー

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

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