FlipLink APIでフリップブック作成を自動化

ダッシュボードからフリップブックを1つずつ公開しているなら、効率化のチャンスを逃しています。FlipLink APIを使えば、PDFのアップロードから設定、公開まで、フリップブック作成のすべてのステップをUIに触れることなく自動化できます。パブリッシングプラットフォームの構築、CMSとの連携、自動レポート生成など、このガイドで始め方をすべて解説します。

なぜフリップブック作成を自動化するのか？

手動のフリップブック作成は、週に数件のドキュメントを処理する分には問題ありません。しかし、定期的に数十、数百のPDFを処理する必要がある場合はどうでしょうか？そこでFlipLink APIが不可欠になります。このガイドで紹介するすべてのエンドポイント、パラメータ、レスポンスは、ブラウザから直接呼び出しを試せるライブのAPIリファレンスに記載されています。

自動化がもたらす利点は以下の通りです。

• スケールでの高速処理 — 数百のPDFを数時間ではなく数分でフリップブックに変換
• 一貫性 — すべてのフリップブックが同じブランディング、設定、構成に従う
• ヒューマンエラーの削減 — スクリプトがプロセスを処理するため、手順の漏れや設定忘れがない
• ワークフロー連携 — 既存のツールやパイプラインからフリップブック作成をトリガー
• オンデマンド公開 — 新しいコンテンツが準備でき次第、即座にフリップブックを生成・配信

FlipLink APIの基本

認証

すべてのAPIリクエストには認証用のAPIキーが必要です。FlipLinkダッシュボードの設定 > APIアクセスからキーを生成できます。各リクエストのX-Api-Keyヘッダーにキーを含めます。

X-Api-Key: YOUR_API_KEY

APIキーを安全に保管してください。環境変数またはシークレットマネージャーに保存し、クライアントサイドのコードにハードコードしたり、バージョン管理にコミットしたりしないでください。詳細はAPIリファレンスの認証セクションをご覧ください。

ベースURLとレート制限

すべてのAPIエンドポイントは、ベースURL https://go.fliplink.me/api の配下にあります。レート制限はAPIキーごとに適用されるため（300リクエスト/分）、バッチ操作を実行する場合は、許可されたしきい値内に収まるようリクエスト間に短い遅延を入れてください。認証失敗の場合はHTTP 401が返されます。それ以外のすべてのケースでは、APIはHTTP 200と、Resultフィールドが"OK"または"ERROR"であるJSONボディを返します。そのため、ステータスコードだけでなく必ずResultで分岐してください。すべてのエンドポイントの一覧とライブの例は、APIリファレンスでご確認いただけます。

PDFのプログラムによるアップロード

自動フリップブック作成の核心は、Create by File エンドポイント POST /api/create-by-file です。マルチパートフォームアップロードとしてPDFを送信すると、FlipLinkがフリップブックに変換します。PDFがすでに公開URLに存在する場合は、代わりに POST /api/create-by-url を使い、FileではなくFileURLを渡してください。

一般的なアップロードリクエストには以下が含まれます。

• PDFファイル（File、マルチパートフォームによるバイナリデータ）
• フリップブックのName（内部用）とTitle（表示用）
• DocType（例：Flipbook）

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@catalog-spring.pdf' \
  -F 'Name=Spring Product Catalog' \
  -F 'Title=Spring Product Catalog' \
  -F 'DocType=Flipbook'

成功した呼び出しは、残りの公開クォータ（Flipbooks_Left）とともに {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} を返します。IDを取得しておきましょう。以下のすべての設定呼び出しで{flipbookId}パスパラメータとして使用します。

APIによるフリップブック設定

PDFのアップロードは最初のステップにすぎません。APIでは、ダッシュボードで通常調整するすべての設定を構成できます。FlipLinkは、すべてをまとめた1つの更新呼び出しではなく、設定グループごとに専用のset-*エンドポイントを公開しています。それぞれが、フリップブックのIDをパスパラメータ（/api/set-…/{flipbookId}）として受け取る、form-urlencodedのPUTです。これにより、バッチパイプラインで各呼び出しを小さく予測可能に保てます。

一般的な設定オプション

• パスワードアクセス — set-password-accessでフリップブックをパスワードで保護
• ブランディング — set-logo、set-background-image、set-skin、set-metaでSEOメタデータとソーシャル画像を設定
• リードキャプチャ — set-lead-capture（およびset-lead-fields、set-lead-webhook、set-lead-google-sheets）で閲覧者情報を収集
• カスタムドメイン — CNAMEエンドポイントで独自ドメインで公開（CNAME設定を参照）
• 公開状態 — set-publishedでオンデマンドに公開・非公開を切り替え
• 共有＆ビューアー制御 — set-share-channels、set-viewer-controlsなど

# Example: password-protect the flipbook you just created
curl -X PUT 'https://go.fliplink.me/api/set-password-access/90001' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=true' \
  --data-urlencode 'Password=spring2026'

各設定呼び出しは {"Result":"OK","Message":"Updated successfully"} を返します。アップロードと設定を分離することで、同じバッチワークフロー内で異なるフリップブックに異なる設定を簡単に適用できます。APIリファレンスには、すべてのset-*エンドポイントが正確なパラメータとライブのTry-Itコンソールとともに一覧表示されています。

バッチ作成ワークフロー

フォルダ全体のPDFを変換する必要がある場合、バッチワークフローが力を発揮します。パターンはシンプルです。

1. ソースディレクトリのPDFファイルをスキャン
2. 各PDFをFlipLink APIにアップロード
3. ルールに基づいて設定（例：ファイル名パターン、メタデータファイル）
4. 生成されたフリップブックURLを記録
5. 関係者や下流システムに通知

以下はPythonの簡略化された例です。

import os
import requests

API_KEY = os.environ["FLIPLINK_API_KEY"]
PDF_DIR = "./catalogs"
BASE = "https://go.fliplink.me/api"
HEADERS = {"X-Api-Key": API_KEY}

results = []

for filename in os.listdir(PDF_DIR):
    if not filename.endswith(".pdf"):
        continue

    filepath = os.path.join(PDF_DIR, filename)
    title = filename.replace(".pdf", "").replace("-", " ").title()

    with open(filepath, "rb") as f:
        response = requests.post(
            f"{BASE}/create-by-file",
            headers=HEADERS,
            files={"File": (filename, f, "application/pdf")},
            data={"Name": title, "Title": title, "DocType": "Flipbook"},
        )

    data = response.json()
    if data.get("Result") == "OK":
        results.append({"title": title, "id": data["ID"], "url": data["URL"]})
        print(f"Created: {title} -> {data['URL']}")
    else:
        print(f"Failed: {title} -> {data.get('Message')}")

print(f"Batch complete: {len(results)} flipbooks created")

レスポンスの処理に注意してください。FlipLinkはアプリケーションエラーの場合でもHTTP 200を返すため、スクリプトはステータスコードではなくJSONのResultフィールドで分岐します。大規模なバッチでは、失敗したアップロードへのリトライを追加し、リクエスト間に短い停止を入れてレート制限（300/分）を尊重してください。

リアルタイム更新のWebhookコールバック

フリップブックが公開されると、Webhookを使ってポーリングする代わりに閲覧者のアクティビティにリアルタイムで反応できます。PUT /api/set-lead-webhook/{flipbookId}を使ってフリップブックごとにWebhookを設定し、ご自身のエンドポイントを指定します。すると、フリップブックがアクティビティ（主に新規リード。閲覧・販売イベントは関連するリードおよび販売設定で利用可能）を取得したときに、FlipLinkがそのURLにPOSTを送信します。

これをプログラムで設定するには次のようにします。

# Send new-lead events for flipbook 90001 to your endpoint
curl -X PUT 'https://go.fliplink.me/api/set-lead-webhook/90001' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'WebhookURL_NewLead=https://example.com/hooks/fliplink'

POST /api/test-webhook/{flipbookId}でいつでもテスト配信を実行し、本番稼働前にハンドラーがペイロードを受信することを確認できます。Webhookはリアルタイムパイプラインを可能にします。新規リードが届いたら、ハンドラーがコンタクトをCRMにプッシュしたり、Slack通知を送信したり、メールキャンペーンをトリガーしたりできます。ノーコードがお好みですか？同じイベントはZapier、Make、n8nを経由してルーティングすることもできます。WebhookとGoogle Sheetsのオプションについては、APIリファレンスのリードキャプチャエンドポイントグループをご覧ください。

実際のユースケース

パブリッシングプラットフォーム

メディア企業やコンテンツプラットフォームは、FlipLinkをパブリッシングパイプラインに統合できます。編集者がマガジン号やニュースレターを最終化すると、システムがPDFエクスポートを自動的にフリップブックに変換してウェブサイトに埋め込みます。手動のステップは一切不要です。

CMS連携

FlipLinkをコンテンツ管理システムに接続し、特定のフォルダやコンテンツタイプにPDFをアップロードすると自動でフリップブックが作成されるようにします。生成された埋め込みコードが関連するページや投稿に挿入されます。製品カタログ、ルックブック、ドキュメントサイトに特に効果的です。

自動レポート配信

財務報告書、四半期レビュー、コンプライアンス文書は多くの場合、予測可能なスケジュールに従います。フロー全体を自動化しましょう。レポートツールからPDFを生成し、API経由でFlipLinkにアップロードし、正しいブランディングとアクセス制御を適用し、関係者にフリップブックリンクを配信する。すべて単一のcronジョブまたはワークフローイベントでトリガーされます。

ECサイトの商品カタログ

カタログを頻繁に更新する小売業者は、商品データが変更されるたびにフリップブックを再生成できます。商品情報管理システムから最新のカタログPDFを取得し、新しいフリップブックを作成し、ストアフロントの埋め込みを入れ替えます。手動作業なしで、顧客に常に最新の在庫情報を表示できます。

APIアクセスと自動化連携の組み合わせ

API単体でも強力ですが、自動化連携と組み合わせるとさらに多用途になります。Zapier、Make、n8nなどのツールを使って、コードを書かずにFlipLinkを何百もの他のアプリに接続できます。例えば：

• Google Drive + FlipLink — 特定のDriveフォルダに新しいPDFが表示されたら自動でフリップブックを作成
• Shopify + FlipLink — 新しいコレクションが公開されたら商品フリップブックを生成
• HubSpot + FlipLink — ブロシュアのリクエスト時にコンタクトレコードにフリップブックリンクを添付

サードパーティツールとの接続について詳しくは、FlipLink APIを連携に活用するガイドをご覧ください。

APIドリブンのフリップブックワークフローのベストプラクティス

• べき等操作を使用 — 各アップロードに一意の参照IDを含め、重複作成せずに安全にリトライ可能に
• エラーを適切に処理 — 失敗をログし、指数バックオフでリトライを実装し、繰り返しのエラーでアラート
• フリップブックIDを保存 — 各ソースPDFをデータベース内のIDにマッピング。すべての読み取り、更新、削除呼び出しで{flipbookId}パスパラメータになります
• ステータスではなくResultで分岐 — アプリケーションエラーはHTTP 200とResult: "ERROR"で返されます。401を使うのは認証失敗のときだけです
• 使用量を監視 — APIコール量を300/分のレート制限に対して追跡し、作成レスポンスのFlipbooks_Leftをアクティブな公開物の上限に対して監視

今すぐ自動化を始めましょう

FlipLink APIは、フリップブック作成を手動タスクからスケーラブルな自動化ワークフローに変えます。週に10件のPDFを処理する場合でも1万件でも、APIが一貫した品質とゼロの手動オーバーヘッドで処理します。

自動化されたフリップブックパイプラインを構築する準備はできましたか？FlipLinkアカウントを作成し、キーを取得して、APIリファレンスを開いてブラウザでエンドポイントをライブで試してみましょう。一度きりの買い切りライフタイムプランは$39からです。詳しくは料金ページをご確認ください。