アカウントの API キーを管理する方法

Klaviyo アカウントの API キーにアクセスして管理する方法をご確認ください。

非公開 API キーの作成または複製については、非公開 API キーの作成方法をお読みください。

API キー：公開キーと非公開キーの違い

公開 API キーは、サイト ID とも呼ばれます。 これは短い英数字から成ります。この公開キーはKlaviyoアカウントの一意の識別子で、アカウントごとに1つのみです。公開APIキーをウェブサイトのコードに含めることができます。これは非公開のアカウントデータを読み取る権限を付与しません。

非公開APIキーを使用すると、選択した権限（スコープ）に応じて、リストなどKlaviyoアカウント内のデータをアプリケーションから読み取ったり変更したりできます。非公開APIキーはパスワードのように扱ってください。安全な場所に保管し、決して一般に公開しないでください。Klaviyoアカウントでは、必要な数だけ非公開APIキーを生成できます。

非公開 API キーが流出した場合の対処法

公開APIキーは、公開ウェブサイトのコードで使用することを目的としています。これにより、非公開のアカウントデータを読み取ることはできませんが、イベントやプロファイルの更新などのデータをクライアントAPIを通じて送信するために使用できます。

非公開APIキーは機密として扱ってください。非公開キーを持つ人は、その権限を使用して顧客データを表示または編集できます。

非公開APIキーが漏えいした場合は、直ちに削除してから、新しい非公開APIキーを作成してください。漏えいしたキーを使用していた各アプリケーションを更新して、新しいキーを使用するようにしてください。置き換え用のキーには、アプリケーションに必要な権限のみを付与し、アプリケーションごとに異なる非公開APIキーを使用してください。

API キーを確認する方法

1. 左下のアカウント名をクリックしてください。
2. [設定] をクリックします。

3. [API キー] タブを選択します。
4. 公開APIキー（サイトID）を確認します。
5. プライベートAPIキーで、キー名とアクセスレベルを確認してください。キーは末尾4文字で識別できますが、ここではキー全体を表示したりコピーしたりすることはできません。

キーがアクティブタブにない場合は、これらのタブが表示されていれば非アクティブまたは無効を確認してください。

非公開 API キーの複製

既存の非公開APIキーを複製すると、複製されたキーは次のようになります：

• 元のキーとはまったく違うキーにしてください。
• 元と同じ名前を使用する。
• 元のものと同じスコープを持ちますが、サポートが終了した廃止済みのスコープを除きます。

複製しても、元のキーはそのまま残ります。複製したキーをコピーまたはダウンロードして、安全に保管してください。アプリケーションで使用するには、新しいキーでそのアプリケーションの設定を更新してください。元のキーが不要になったら削除してください。

非公開APIキーの削除

非公開APIキーを削除すると、取り消せません。これを使用したAPIリクエストは機能しなくなります。公開されていないキーを置き換える場合は、削除する前に、それを使用しているアプリケーションを更新してテストしてください。キーが公開されている場合は、すぐに削除してください。

1. 上記の手順に従って、APIキータブを開いてください。プライベートAPIキーで、削除するキーを見つけてください。
2. キーの横にある3点メニューを開き、削除を選択してください。
3. 確認ダイアログで削除をクリックしてください。

その他のリソース