REST API

REST API（Representational State Transfer Application Programming Interface）は、標準的なHTTPメソッド — GET、POST、PUT、PATCH、DELETE — を使用してリソースの作成、読み取り、更新、削除を行うウェブサービスエンドポイントの集合です。各リソースはURLで識別され、サーバーは構造化データ（通常JSON）で応答します。REST APIはステートレスなリクエスト-レスポンスパターンに従い、各呼び出しがサーバーの処理に必要なすべての情報を含み、前のリクエストに依存しません。ウェブ上でアプリケーション間のプログラマティックなデータ交換に最も広く採用されているアプローチです。

デジタルパブリッシャーにとって、REST APIはフリップブックプラットフォームを独立したダッシュボードから、より大きなワークフローに組み込めるプログラマブルな構成要素に変えます。PDF アップロード、フリップブック作成、[アナリティクス](/glossary/analytics-dashboard)データの取得などの自動化を手動操作なしで実現します。何百ものドキュメントを公開するチームは、繰り返しタスクのスクリプト化で大幅な時間節約が可能です。REST APIはCRM、マーケティングプラットフォーム、コンテンツ管理システムとの統合も可能にし、パブリッシングプラットフォームを接続されたツールチェーンの一部にします。

FlipLinkの[APIアクセス](/features/api-access)機能により、開発者はフリップブックとドキュメントをプログラムで作成、更新、一覧表示、削除できます。PDFのアップロード、ビューア設定の構成、アナリティクスデータの取得、認証済みAPIエンドポイントを通じたリード管理が可能です。APIは[自動化とインテグレーション](/features/automation-and-integrations)エコシステムと統合されており、リアルタイムイベントを自システムにプッシュする[Webhook](/glossary/webhook)も含まれます。認証にはアカウントに紐づいたAPIキーを使用し、すべてのリクエストとレスポンスはJSON形式です。レート制限が文書化されており、信頼性の高い自動化を構築できます。

REST APIは、予測可能性を実現する少数の規約に基づいています： - **リソースとURL** — 各エンティティ（フリップブック、リード、アナリティクスレポート）は固有のURLを持ちます。例えば、`/api/get/abc123` は特定のフリップブックを識別します。 - **HTTPメソッドがアクションに対応** — GETは読み取り、POSTは作成、PUT/PATCHは更新、DELETEは削除。メソッドがサーバーに何をしたいかを伝え、URLがどのリソースかを指定します。 - **ステートレス** — サーバーは前のリクエストを記憶しません。各呼び出しが独自の認証トークンとパラメータを含みます。これによりクラスタ内のどのサーバーでもどのリクエストでも処理できるため、スケーリングが容易です。 - **ステータスコード** — サーバーは標準HTTPコードで応答：200は成功、201は作成完了、400は不正なリクエスト、401は未認証、404は未検出、429はレート制限超過。 - **ページネーション** — リストエンドポイントは結果をページ単位で返し、合計数と次ページへのリンクを含むメタデータが付属します。

**「REST APIとAPIは同じもの。」** RESTはAPIのアーキテクチャスタイルの一つです。他のスタイルにはGraphQL、gRPC、SOAPがあります。誰かが「API」と言う場合、通常RESTを意味しますが、用語は互換ではありません。 **「REST APIにはJSONが必須。」** JSONは最も一般的な形式ですが、REST自体は特定のデータ形式を義務づけていません。一部のAPIはコンテンツネゴシエーションヘッダーを通じてXMLなどの形式をサポートしています。実際には、FlipLinkを含む現代のREST APIのほとんどはJSON のみを使用しています。 **「ステートレスとはサーバーがすべてを忘れるということ。」** ステートレスは個々のリクエストに対する概念であり、プラットフォーム全体ではありません。サーバーはフリップブック、設定、データをデータベースに保存し続けます。ステートレスとは、各API呼び出しが独自の認証とコンテキストを含む必要があるということです。

**REST APIと[Webhook](/glossary/webhook)の違いは何ですか？** REST APIはアプリケーション側からリクエストを開始する必要があります — データを要求したりコマンドを送信したりします。Webhookは逆方向に機能します：何かが起こったとき（新しいリード獲得、フリップブック閲覧など）にサーバーがアプリケーションにイベントをプッシュします。多くのワークフローでは両方を使用します：オンデマンド操作にREST API、リアルタイム通知にWebhookです。 **RESTful APIとは何ですか？** 「RESTful」とは、APIがREST原則に従うことを意味します：リソースベースのURL、標準HTTPメソッド、ステートレス通信、構造化レスポンス。「REST API」と「RESTful API」は実際には同義で使用されます。 **REST APIの使用にプログラミングスキルは必要ですか？** カスタムコードが最も柔軟性を提供しますが、Zapier、Make、n8nなどのノーコードプラットフォームはビジュアルインターフェースを通じてREST APIとやり取りできます。FlipLinkの[APIアクセス](/features/api-access)はカスタムコードと自動化プラットフォームの両方で動作します。

REST APIはウェブサービスへのプログラマティックアクセスの標準インターフェースです。FlipLinkユーザーにとって、パブリケーションの作成、管理、分析を含むあらゆるワークフローを、ダッシュボード単体で提供できる範囲を超えて自動化、統合、スケールできることを意味します。