29 lines
1.2 KiB
Markdown
29 lines
1.2 KiB
Markdown
|
---
|
|||
|
|
sidebar_position: 8
|
|||
|
|
title: "サブスクリプション"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# サブスクリプションとサービス
|
|||
|
|
|
|||
|
|
アクティブなサービスの表示と更新方法を説明します。
|
|||
|
|
|
|||
|
|
## データソース
|
|||
|
|
|
|||
|
|
- サブスクリプション（サービス/商品）はマッピングされたクライアントID経由でWHMCSから読み取ります。
|
|||
|
|
- ステータス（Active、Pending、Suspended、Cancelled、Completed）はWHMCSから直接取得。
|
|||
|
|
|
|||
|
|
## 鮮度
|
|||
|
|
|
|||
|
|
- サブスクリプション一覧は5分、個別サブスクリプションは10分キャッシュ。
|
|||
|
|
- WHMCSが変更を通知（Webhook）するか、関連サービスに影響する可能性のあるプロフィール/住所データを更新した際にキャッシュをクリア。
|
|||
|
|
|
|||
|
|
## 表示内容
|
|||
|
|
|
|||
|
|
- WHMCSに保存されているサービス名、ステータス、開始日、金額、通貨。
|
|||
|
|
- サブスクリプションはダッシュボード統計にも使用（例：アクティブ数）。統計はキャッシュ無効化後に更新。
|
|||
|
|
|
|||
|
|
## エラー時の動作
|
|||
|
|
|
|||
|
|
- WHMCSマッピング不足：空のリストではなく明確なエラーを返却。
|
|||
|
|
- WHMCS利用不可：「後でやり直してください」を表示。失敗をキャッシュしません。
|