エンタープライズソリューション：Wix API キーを使用する | サポートセンター

エンタープライズソリューション：Wix API キーを使用する

読了時間：10分

Wix API キーは、ユーザーまたはアプリケーションを認証し、サイトやアカウントデータへのアクセスを許可するために生成できるコードです。

Wix API キーを使用して、注文、商品、イベントなどのサイトデータに安全にアクセスしましょう。このデータを使用して、Wix ストアや Wix ブッキングなどの Wix ビジネスソリューションに接続するための独自のカスタム機能を構築したり、サードパーティのサービスに接続したりすることができます。また、新しいアカウントの作成など、アカウントレベルのデータへのアクセスや更新も可能です。

API キーは、エンタープライズダッシュボードの「設定」セクションで管理できます。新しいキーの生成、既存のキーのローテーションまたは複製、詳細と権限の編集、不要になったキーの削除などを行うことができます。

Wix Studio エンタープライズに関する詳細を確認するか、販売チームにお問い合わせください。

この記事では、次の項目について説明します：

Wix API キーについて

アプリケーションプログラミングインターフェース（API）は、コンピューター間のリクエストと応答のやり取りに使用される通信プロトコルです。たとえば、メールアドレスとパスワードを使用して Wix アカウントにログインすると、API が資格情報を使用して Wix へのログイン権限を認証します。

API キーは、ユーザーまたはアプリケーションが自身を認証するために API に送信できるコード（文字列）です。API キーが有効な場合、API はそのデータへのアクセスを許可します。アクセスできる特定のデータは、API キーの権限セットに基づいて決まります。

Wix API キーを使用して Wix API を呼び出す

エンタープライズダッシュボードで生成した API キーを使用すると、Wix API を使用してアカウントおよびサイトのデータにアクセス・管理し、カスタム機能を構築することができます。

たとえば、ストアから商品リストを取得する、ストアに新商品を追加する、またはその新商品について SNS に自動的に投稿するといった操作を実行できます。

API キーを使用してリクエストを作成する方法はこちら（英語）

Wix API キーを生成する

エンタープライズダッシュボードの「設定」セクションで、サイトのデータにアクセスするための API キーを生成することができます。

重要：

デフォルトでは、生成した各 API キーによってアカウント内のすべてのサイトにアクセスすることができます。これは、API キーがアカウントレベルで生成されるためです。
セキュリティを強化するため、生成した各 API キートークンは作成時に一度だけ表示されます。
「API キーが生成されました」ポップアップを閉じた後、API キーのトークンを再度表示することはできません。今後アクセスできるよう、トークンは安全な場所に保管してください。

API キーを生成する方法：

エンタープライズダッシュボードで「API キー」にアクセスします。
右上の「＋API キーを生成する」をクリックします。
「キーの詳細」下に新しい API キーの名前を入力します。
API キーに割り当てるアクセス権を選択します。
- アカウント内のすべてのサイトの ID を返す基本のアクセス権がデフォルトで選択されています。この選択を解除することはできません。
- セキュリティ確保のため、必要なアクセス権のみを追加してください。API セキュリティに関する詳細はこちら
「キーを生成する」をクリックします。
「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
メールを開いて認証コードを取得します。
「アカウントを認証」ポップアップにコードを入力します。
「認証してキーを生成する」をクリックします。

「トークンをコピーして閉じる」をクリックします。
トークンを安全な場所に保管します。

ヒント：

同じアクセス権を持つ別の API キーが必要な場合は、API キーをローテーションまたは API キーを複製することができます。

Wix API キーをローテーションする

API キーをローテーションして、同じ名前、説明、アクセス権を維持したまま、新しいトークンを作成することができます。API キーをローテーションすると、以前アクセス権を持っていたユーザーはそのキーを使用できなくなるため、新しいトークンを共有する必要があります。

重要：

API キーをローテーションすると、それを使用していたユーザーやアプリケーションは即座にデータにアクセスできなくなります。
API キーを更新した後は、以前のトークンを復元することはできません。

ヒント：

ほとんどの場合は、API キーを複製し、新しいトークンを API コールに追加して、その新しいトークンを必要とするチームメンバーに共有することが推奨されます。古い API キーは削除してください。
これにより、キーを使用する API のサービスが中断されることはありません。
API キーのローテーションは、キーが侵害されたと思われる場合にのみ行うことをおすすめします。

API キーをローテーションする方法：

エンタープライズダッシュボードで「API キー」にアクセスします。
右上の「＋API キーを生成する」をクリックします。
ローテーションしたい API キー横の「その他のアクション」アイコンをクリックします。
「ローテーション」を選択します。

ポップアップで「ローテーションする」をクリックします。
「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
メールを開いて認証コードを取得します。
「アカウントを認証」ポップアップにコードを入力します。
「認証してキーをローテーションする」をクリックします。

「トークンをコピーして閉じる」をクリックします。
トークンを安全な場所に保管します。

Wix API キーを複製する

同じアクセス権を持つ別の API キーが必要な場合は、既存の API キーのいずれかを複製することができます。キーを複製した後、さらにカスタマイズする必要がある場合はその説明とアクセス権を編集することもできます。

重要：

デフォルトでは、生成した各 API キーによってアカウント内のすべてのサイトにアクセスすることができます。これは、API キーがアカウントレベルで生成されるためです。
セキュリティを強化するため、生成した各 API キートークンは作成時に一度だけ表示されます。
「API キーが生成されました」ポップアップを閉じた後、API キーのトークンを再度表示することはできません。今後アクセスできるよう、トークンは安全な場所に保管してください。

API キーを複製する方法：

エンタープライズダッシュボードで「API キー」にアクセスします。
複製したい API キー横の「その他のアクション」アイコンをクリックします。
「複製」を選択します。

「キーの詳細」下に新しい API キーの新しい名前を入力します。
（オプション）API キーに割り当てられているアクセス権を編集します。
- アカウント内のすべてのサイトの ID を返す基本のアクセス権がデフォルトで選択されています。この選択を解除することはできません。
- セキュリティ確保のため、必要なアクセス権のみを追加してください。詳細はこちら
「キーを生成する」をクリックします。
「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
メールを開いて認証コードを取得します。
「アカウントを認証」ポップアップにコードを入力します。
「認証してキーを生成する」をクリックします。