Klaviyo API のスタートガイド

推定 1 分で読めます

更新日 2025年8月18日 0:00 EST

このページで学べること

API 呼び出しの基礎を理解し、Klaviyo の API がビジネスにもたらすメリットを把握しましょう。このガイドでは、REST API、HTTP メソッド、開発者ツールについて学び、Klaviyo の API をテストする準備を行います。最初の API コールは、開始から完了まで最短 10 分で実行できます。すでに API コールに慣れていて API のテストを開始する準備ができている場合は、Postman コレクションの使用方法に関するガイドに従ってください。

このガイドでは、新しい技術用語が導入されるたびに用語集へのリンクを掲載します。ガイド内で単語の意味が不明な場合は、技術用語集をご確認ください。

REST API とは何ですか？

REST API は、Representational State Transfer と Application Programming Interface を表す頭字語のセットです。これらの用語は、ソフトウェアが別のソフトウェアとやり取りし、情報を相互に受け渡すことを可能にする構造化されたリクエストとして、より簡単に理解できます。API コールを行うと、情報が保存されているサーバーにリクエストを送信し、その後、要求したデータが JSON（JavaScript Object Notation）形式で含まれるレスポンスが返されます。

より簡単に言うと、REST API を使用すると、Klaviyo に保存されているデータストアをリクエストし、人とコンピューターの両方が読み取れる形式でそのデータを返してもらうことができます。

標準の API 呼び出しは数秒で完了します。バックグラウンドで、呼び出しは次の処理を実行します：

インターネット経由で API に対して、データの構造化リクエストを送信します。リクエストは HTTP を介して送信されます。HTTP は基本的なネットワークリクエストタイプで、インターネットの大部分はこれを基盤として構築されています。
API はリクエストを受信して処理し、Klaviyo のデータベースから要求された情報を取得します。
次に API は、JSON 構造化形式を使用してクライアントアプリケーションに応答します。
クライアントアプリケーションから JSON レスポンスを受け取ります。

この知識はデータ転送の仕組みを理解するのに役立ちますが、API 呼び出しを開始して、Klaviyo の API が提供する価値を得るために必須ではありません。最初の API 呼び出しを始めるために知っておくべきことは、次のセクションで説明します。

HTTP メソッド

HTTP メソッドは、リクエストの送信に使用される「動詞」です。このガイドでは、次の 2 つの HTTP メソッド（GET と POST）を取り上げます。

ここでは使用しませんが、多くの REST API は PUT、PATCH、DELETE などの追加の HTTP メソッドもサポートしている点は覚えておくとよいでしょう。

GET

GET リクエストは、「read」リクエストとして最も簡単に理解できます。GET リクエストは API エンドポイントから情報を取得し、JSON 形式のレスポンスで返します。これらのリクエストではデータの読み取りのみが可能で、この方法ではデータを変更したり上書きしたりできないため、最も安全な種類のリクエストです。

POST

POST リクエストは、簡単に言うと「書き込み」リクエストとして理解できます。POST を使用すると、新しいリソースを作成または追加できます。例えば、List API への POST リクエストはアカウントに新しいリストを作成するために使用でき、GET リクエストは利用可能なすべてのリストを取得するために使用できます。データを投稿する場合、Klaviyo がリクエストを完了できるタイミングによってレスポンスは異なる点にご注意ください。

必要なツール

API はワークフローに高い柔軟性をもたらし、目的の結果を得るために特定のクライアントアプリケーションや言語ライブラリを使用する必要はありません。API 呼び出しは HTTP リクエストを使用して行われるため、ほぼすべてのプログラミング言語には、このタイプのリクエストをネイティブに、または広く利用可能な言語ライブラリを通じて送信する機能があります。さらに、使用しているマシンやオペレーティングシステムによっては、Apple のターミナルや Windows のコマンドラインなどのネイティブアプリケーションを使用して、クライアアント側の API 呼び出しを行うこともできます。ただし、これらのアプリケーションでは、コマンドラインインターフェイスに関する事前知識が必要です。

Postman という無料のウェブおよびデスクトップアプリケーションを使用します。Postman には、エンドポイント、パラメータ、認証を便利なユーザーインターフェースに入力して API リクエストを設定・送信しやすくするためのさまざまな機能があります。

Klaviyo の API をテストする

Klaviyo の API は、他のプラットフォームやサーバーから Klaviyo アカウントへデータを送信したり、Klaviyo アカウント内の情報を照会したりする際に役立ちます。API の仕組みを理解できたので、ビジネスのユースケースに合わせて API のテストを開始できます。Klaviyo で利用可能な API の一覧については、API リファレンスドキュメントをご覧ください。最初の Klaviyo API 呼び出しを行うには、当社の Postman コレクションの使用方法に関するガイドに従ってください。