---
sidebar_position: 8
title: "サブスクリプション"
---

# サブスクリプションとサービス

アクティブなサービスの表示と更新方法を説明します。

## データソース

- サブスクリプション（サービス/商品）はマッピングされたクライアントID経由でWHMCSから読み取ります。
- ステータス（Active、Pending、Suspended、Cancelled、Completed）はWHMCSから直接取得。

## 鮮度

- サブスクリプション一覧は5分、個別サブスクリプションは10分キャッシュ。
- WHMCSが変更を通知（Webhook）するか、関連サービスに影響する可能性のあるプロフィール/住所データを更新した際にキャッシュをクリア。

## 表示内容

- WHMCSに保存されているサービス名、ステータス、開始日、金額、通貨。
- サブスクリプションはダッシュボード統計にも使用（例：アクティブ数）。統計はキャッシュ無効化後に更新。

## エラー時の動作

- WHMCSマッピング不足：空のリストではなく明確なエラーを返却。
- WHMCS利用不可：「後でやり直してください」を表示。失敗をキャッシュしません。
