FlipLink APIでカスタム連携を構築する方法

数十（あるいは数百）のフリップブックを管理している場合、ダッシュボードですべてを手動で行うのはすぐに面倒になります。そこでFlipLink APIの出番です。APIを使えば、プログラムでフリップブックを作成し、出版物を管理し、アナリティクスを取得し、FlipLinkを既存のツールやワークフローに組み込むことができます。

カスタム連携を構築する開発者の方も、繰り返しのタスクを自動化したいチームリーダーの方も、このガイドではAPIの機能と始め方を解説します。

FlipLink APIでできること

FlipLink REST APIは、ダッシュボードで利用できるのと同じ機能へのプログラムによるアクセスを提供します。UIをクリックする代わりに、HTTPリクエストを送信して構造化されたJSONレスポンスを受け取ります。

実現できることは以下のとおりです。

• ダッシュボードを開かずにPDFファイル（アップロードまたはURL）からフリップブックやドキュメントを作成
• メタデータ、リードキャプチャフォーム、スキン、アクセス制御などの出版物設定を更新
• フリップブックごとの閲覧数、さらにリードと販売の完全なエクスポートなどエンゲージメントデータを取得
• 数十のフリップブックを1つのスクリプトで作成、更新、削除するなど大規模に出版物を管理
• 新規リードが獲得されたときに発火するフリップブックごとのWebhookでワークフローをトリガー

プログラム機能の全体概要は、APIアクセスの機能ページをご覧ください。正確なエンドポイント、パラメータ、ライブの例についてはAPIリファレンスをご覧ください。

APIキーの取得

APIコールを行う前に、APIキーが必要です。取得方法は以下のとおりです。

1. go.fliplink.meでFlipLinkダッシュボードにログイン
2. 設定 → APIアクセスに移動
3. APIキーを生成をクリック
4. キーをコピーして安全に保管—パスワードと同様に扱ってください

APIキーはすべてのリクエストを認証します。X-Api-Keyヘッダーに含めてください。

X-Api-Key: YOUR_API_KEY

重要： APIキーをクライアントサイドのコードや公開リポジトリに露出させないでください。サーバーサイドまたは環境変数で保管してください。詳細はAPIリファレンスの認証セクションで解説しています。

一般的なAPIユースケース

フリップブックの一括作成

フリップブックに変換する必要がある50件の製品カタログフォルダがありますか？1つずつアップロードする代わりに、PDFをループして各ファイルの作成エンドポイントにリクエストを送るスクリプトを書きましょう。最大効率のために一括操作と組み合わせてください。

独自ダッシュボードへのアナリティクス取り込み

マーケティングパフォーマンスをカスタムダッシュボード、Google Sheets、BIプラットフォームなどの一元管理ツールで追跡している場合、APIを通じてFlipLinkの閲覧・エンゲージメントデータを取得し、他の指標と統合できます。

大規模な出版物管理

リブランディング後にすべてのフリップブックのブランディングを更新する必要がありますか？前四半期のカタログをアーカイブしますか？APIなら、各出版物を個別にクリックすることなく、これらの更新を一括で処理できます。

オートメーションプラットフォームとの接続

APIをZapier、Pabbly、Makeなどのツールと組み合わせて、ノーコードワークフローを構築できます。例えば、特定のGoogle Driveフォルダに新しいPDFが追加されるたびに、自動的にフリップブックを作成できます。ステップバイステップの手順はFlipLinkをオートメーションプラットフォームに接続する方法のガイド、またはオートメーションと連携機能をご覧ください。

🚀

FlipLinkを無料で試す

PDFを数秒で変換。登録もクレジットカードも不要 — アップロードするだけです。

Drop your PDF here or click to browse

最大40MB

$39 からの有料プランなら、上限が 150 MB に広がります。

例：APIでフリップブックを作成

curlを使ってPDFアップロードから新しいフリップブックを作成する基本的な例です。

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

APIはJSONレスポンス—{"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...}—を返し、フリップブックを即座に配信するために必要な出版物IDと共有URLが含まれます。PDFがすでにオンラインにありますか？POST /api/create-by-urlに切り替えて、Fileの代わりにFileURLを渡してください。

Python、Node.js、またはHTTPをサポートする任意の言語でも同じことができます。APIは標準的なRESTで、ボディはform-urlencoded（またはマルチパート）なので、すでに使用しているスタックで動作します。1つ覚えておくべきこと：アプリケーションエラーはHTTP 200とResult: "ERROR"で返されます（認証失敗のみ401を返します）。そのためResultフィールドで分岐してください。

利用可能なAPIエンドポイント

これはほんの一部です—80以上のエンドポイントの完全なカタログは、それぞれパラメータとライブのTry-ItコンソールとともにAPIリファレンスにあります。

すべてのエンドポイントはJSONを返します。レート制限はAPIキーごとに300リクエスト/分です。各エンドポイント、そのパラメータ、エラーモデル、依存関係パスについてはAPIリファレンスをご覧ください。

APIとダッシュボードの使い分け

すべてにAPIコールが必要なわけではありません。簡単な判断基準をご紹介します。

• 単一のフリップブックを作成する場合、デザイン設定を視覚的に調整する場合、またはアナリティクスをカジュアルに確認する場合はダッシュボードを使用
• 5つ以上の出版物を同時に処理する場合、他のシステムと連携する場合、または定期的なタスクを自動化する場合はAPIを使用
• コードを書かずにAPIレベルのパワーが必要な場合はオートメーションプラットフォーム（Zapier／Make／Pabbly）を使用

定期的に更新される製品カタログやコンテンツを管理するチームにとって、APIは最初のバッチ実行で節約できる時間だけで元が取れます。

構築を始めましょう

FlipLink APIは手作業の繰り返しを自動化ワークフローに変えます。アナリティクスのダッシュボード同期、コンテンツパイプラインからのフリップブック一括作成、FlipLinkのCRMへの組み込みなど、APIはニーズに合ったものを正確に構築するためのコントロールを提供します。

始める準備はできましたか？ 無料FlipLinkアカウントを作成して、APIキーを生成し、APIリファレンスを開いてブラウザですべてのエンドポイントをライブで試してみましょう。APIアクセスに含まれる機能については料金ページをご覧ください。