再販エージェンシー向け：APIキーをクライアント別にグルーピングする方法
PDF生成APIを自社サービスに組み込んで複数のクライアントに提供している代理店・受託開発会社、あるいは複数テナントを抱えるSaaS運営者にとって、最も面倒なのが「どのキーが、どのクライアント向けで、いくら使ったのか」を毎月集計する作業です。
FUNBREW PDFはこの問題を解決するため、APIキーにクライアント名とタグを付与してグルーピングできる機能を提供しています。生成PDF・APIログ・利用量をクライアント単位で絞り込み、CSVエクスポートで請求按分の根拠資料まで一気通貫で出力できます。再販シナリオはユースケース集でも詳しく紹介しています。
この記事では、再販シナリオでの具体的な運用方法と、ベストプラクティスを解説します。
なぜAPIキーのグルーピングが必要か
よくある運用課題
- 請求按分が手作業: 月末にスプレッドシートで「Acme社のキーは10,000件、Beta社は3,000件」と1つずつ集計
- ログの絞り込みができない: トラブル発生時、「Acme社の生成だけ見たい」のに全社ログから検索
- キー管理が属人化: 「sk-xxxxx は誰のキーだっけ？」と後任が困る
グルーピングで解決すること
| 課題 | グルーピング後 |
|---|---|
| 請求按分の手作業 | CSV出力で client_label 列を見るだけ |
| ログの絞り込み | クライアント名で1クリック |
| キーの属人化 | ダッシュボードで一目瞭然 |
client_label と tags の使い分け
迷ったときは下の表を見れば一発です。「請求書を分けたい単位」が client_label、それ以外の付箋が tags と覚えてください。
client_label |
tags |
|
|---|---|---|
| 個数 | 1つだけ | 複数可 |
| 役割 | 請求按分・集約のメイン軸 | 環境・用途などの補助分類 |
| 例 | Acme Inc |
production, invoice-pdf |
| CSV出力 | client_label 列に出力（請求根拠） |
現状は出力対象外（管理画面のみ） |
| 表記揺れ | フィルタが効かなくなるので注意 | 比較的緩くてOK |
実際の使い方
ステップ1: APIキーにクライアント情報を付与
ダッシュボード → APIキー → 「新規発行」または既存キーの「編集」を開きます。
- キー名: 内部管理用の名前（例:
Acme Production） - クライアント / プロジェクト: クライアント企業名やプロジェクト名（例:
Acme Inc） - タグ: 環境や用途（例:
production,invoice-pdf）
Tip: 同じクライアントに複数キーを発行する場合（環境別・用途別）も、
client_labelを同じ値で揃えておけば、後でクライアント単位で集約できます。
ステップ2: PDFファイルとAPIログをクライアント別に絞り込み
ダッシュボードのPDFファイル一覧・APIログ画面に「クライアント」フィルタが追加されます。
複数のキー（例: Acmeの本番キーとステージングキー）に同じ client_label を付与している場合、フィルタは両方のキーで生成されたPDFをまとめて表示します。キー単位ではなくクライアント単位の集約ビューになるのがポイントです。
ステップ3: CSV出力で請求按分
PDFファイル一覧の「CSVエクスポート」を実行すると、以下の列が出力されます。
filename,original_name,source_type,file_size,download_count,...,api_key,client_label
abc123.pdf,"Acme請求書_2026-04.pdf",html,254078,1,...,Acme Production,Acme Inc
def456.pdf,"Beta契約書.pdf",html,128400,2,...,Beta Production,Beta Corp
client_label 列でピボットすれば、クライアント別の生成件数・ファイルサイズ・ダウンロード数が一発で集計できます。月末の請求書発行作業がほぼ自動化されます。
再販シナリオ別ベストプラクティス
シナリオ1: 代理店モデル（クライアント企業ごとに別々の請求）
client_label: "Acme Inc" tags: ["production"]
client_label: "Acme Inc" tags: ["staging"]
client_label: "Beta Corp" tags: ["production"]
client_label: "Gamma Studio" tags: ["production", "trial"]
- 月次CSVを
client_labelでグループ化 → 各クライアントへの請求書根拠に - トライアル中の Gamma Studio は
trialタグで識別、転換時にproductionタグへ更新
シナリオ2: マルチテナントSaaS
client_label: "tenant_001" tags: ["plan:pro", "production"]
client_label: "tenant_002" tags: ["plan:enterprise", "production"]
client_labelにテナントIDを使えば、自社DBと突き合わせやすい- プラン情報をタグに入れておけば、利用量超過の検知に使える
シナリオ3: 受託開発・案件単位
client_label: "Project Alpha" tags: ["delivered", "support-2026"]
client_label: "Project Beta" tags: ["development"]
- 納品済み案件を
deliveredタグでマーク、サポート期間中はsupport-yyyyタグで管理 - サポート問い合わせ時に該当プロジェクトのログだけを参照
設計上の注意点
グルーピングは管理用ラベル
client_label と tags は管理画面での絞り込み・集計のためのメタデータで、APIの動作（レート制限、課金、スコープなど）には影響しません。クライアント単位でレート制限を分けたい場合は、現状はキーごとの分離で対応してください。
キーは安全に保管
クライアントに直接APIキーを渡す再販モデルではなく、自社サーバーがプロキシ的にAPIキーを保持し、クライアントのリクエストをFUNBREW PDFへ中継する運用を推奨します。クライアントごとに別キーを使い、client_label で識別すれば、万が一漏洩した際のキーローテーションも限定的な影響で済みます。
命名規則を最初に決める
複数人で運用する場合、client_label の表記揺れ（Acme Inc / acme inc / Acme Inc.）が起きるとフィルタが効かなくなります。社内で命名規則（例: 正式社名、半角スペース、敬称なし）を最初に決めておきましょう。
まとめ
PDF生成APIを再販する場合、APIキーのグルーピングは請求按分・サポート対応・運用引き継ぎの3つを劇的に楽にします。
client_labelでクライアント単位の集約tagsで環境・用途の細分化- CSV出力で請求按分の自動化
すでにAPIキーを発行済みの場合も、ダッシュボードから既存キーを編集して client_label と tags を追加するだけで、過去のPDF・ログも遡ってフィルタできます。
詳しい使い方は公式ドキュメントを、APIキーの発行はダッシュボードからどうぞ。実装をすぐに試してみたい方はプレイグラウンドで動作確認もできます。請求書PDFの自動化全体については請求書APIガイドも参考にどうぞ。