よくある質問
基本
FUNBREW PDFとは?
FUNBREW PDFは、HTMLやURLからPDFを生成するREST APIです。請求書、証明書、レポートなどのドキュメント生成を自動化するために設計されています。Chromium(高品質)とwkhtmltopdf(高速)の2つのエンジンを搭載しています。
無料プランはありますか?
はい。Freeプランは月30件まで無料で、クレジットカードは不要です。ダッシュボードからいつでもアップグレードできます。
日本語は使えますか?
はい。日本語、中国語、韓国語などのCJK文字に完全対応しています。フォントはサーバーにプリインストール済みです。
カスタムフォントは使えますか?
HTMLにCSS @font-faceでフォントを埋め込めます。Google Fontsなどのウェブフォントもそのまま使えます。
PDFエンジン
「高品質」と「高速」エンジンの違いは?
高品質(quality)はChromiumベースでCSS3/Flexbox/Gridに完全対応。高速(fast)はwkhtmltopdfベースで処理が速い代わりにCSS対応が限定的です。デフォルトは高品質エンジンです。
Freeプランでも高品質エンジンは使えますか?
Freeプランでは高速エンジン(wkhtmltopdf)のみ利用可能です。高品質エンジン(Chromium)はBasicプラン以上で利用できます。Playgroundでは無料で高品質エンジンをお試しいただけます。
デフォルトのエンジンを変更できますか?
はい。ダッシュボードのアカウント設定から企業全体のデフォルトエンジンを設定できます。APIリクエストでoptions.engineを指定すれば、リクエスト単位で切り替えることもできます。
有効期限・ダウンロード
PDFの有効期限はどうなりますか?
デフォルトでは生成から24時間後に期限切れになります。expiration_hoursパラメータで1〜168時間(最大7日)の間で指定できます。0を指定すると無期限になります。
デフォルトの有効期限を変更できますか?
はい。ダッシュボードの「ダウンロードページ」設定から、企業全体のデフォルト有効期限を変更できます。スイッチで無期限にすることもできます。
ファイルを無期限にするには?
APIリクエストでexpiration_hours=0を指定するか、ダッシュボードのダウンロード設定でデフォルト有効期限を無期限に設定してください。無期限のファイルは自動削除されません。
ダウンロード回数の制限は?
デフォルトは無制限(0)です。max_downloadsパラメータで制限を設定できます。ダッシュボードの「ダウンロードページ」設定からデフォルト値を変更することもできます。
期限切れファイルはいつ削除されますか?
期限切れから7日後に自動削除されます(猶予期間)。無期限のファイル(expiration_hours=0)は自動削除されません。
テンプレート
テンプレートとは?
テンプレートは、{{変数名}}形式のプレースホルダーを含むHTMLレイアウトです。ダッシュボードのテンプレートエディタで作成・編集でき、APIコール時に変数を渡すだけでPDFが生成されます。
テンプレートエディタの使い方は?
ダッシュボードの「テンプレート」→「新規作成」から使えます。コードエディタ(シンタックスハイライト付き)で編集しながら、右側でリアルタイムプレビューが確認できます。スニペット(明細テーブル、ヘッダー等)をワンクリックで挿入することもできます。
テンプレート変数のデフォルト値は設定できますか?
はい。テンプレートエディタの変数定義パネルで、各変数にデフォルト値と説明を設定できます。APIコール時に変数が未指定の場合、デフォルト値が使われます。
セキュリティ
データのセキュリティは?
すべてのAPI通信はHTTPSで行われます。APIキーはSHA-256でハッシュ化。S3認証情報は暗号化して保存。企業ごとにIP制限を設定できます。二要素認証(TOTP)にも対応しています。
二要素認証は使えますか?
はい。ダッシュボードのアカウント設定から二要素認証(TOTP)を有効化できます。Google AuthenticatorやAuthyなどの認証アプリに対応しています。リカバリーコードも発行されます。
APIキーの権限を制限できますか?
はい。APIキーごとにスコープ(generate, download, manage, template, merge)を設定できます。例えば「生成のみ」のキーを発行して、ダウンロードや削除はできないようにすることが可能です。
通知
PDFをメールで送れますか?
はい。APIコールにemailパラメータを追加すると、生成されたPDFがメール添付で送信されます。ダッシュボードから自動メール配信を設定することもできます。
Webhook通知はどのイベントに対応していますか?
pdf.generated(生成完了)、pdf.downloaded(ダウンロード)、pdf.expired(期限切れ)の3イベントに対応しています。Slack Webhookを登録すると、自動的にBlock Kit形式で通知されます。
月間上限に近づいたら通知されますか?
はい。月間生成数が上限の80%、90%、100%に到達すると、企業のcontact_emailにアラートメールが自動送信されます。同月内の同じ閾値のアラートは1回のみです。
料金・プラン
プランのアップグレード方法は?
ダッシュボードの「課金」ページからプランを変更できます。アップグレードは即時反映されます。
いつでも解約できますか?
はい。課金ページからいつでもFreeプランへのダウングレードやサブスクリプションの解約ができます。解約手数料はありません。
Enterprise Proプランとは?
月額¥198,000〜の専用インフラプランです。無制限のPDF生成、専用サーバー、SLA、専任サポートが含まれます。ご利用規模に応じたお見積りとなります。
その他
稼働率の保証は?
99.9%の稼働率を目標としています。本番グレードのインフラで自動監視を行っています。Enterprise Proプランでは SLA を提供します。
サポートはどうなっていますか?
Free〜Basicプランはメールサポート。Standardプランは優先メール。Enterprise Proプランは専任サポートです。funbrew.techまでお問い合わせください。
生成したPDFを自社のS3に保存できますか?
はい。Enterpriseプラン以上でS3互換ストレージ(AWS S3, Wasabi等)への自動アップロードを設定できます。ダッシュボードの「S3ストレージ」から接続情報を登録してください。
一括でPDFを生成できますか?
はい。Standardプラン以上でバッチAPIを利用できます。最大100件のHTMLまたはURLを1回のAPIコールで送信し、非同期で処理されます。バッチIDで進捗を確認できます。
他にご質問がありましたら、お気軽にお問い合わせください。
お問い合わせ