エンタープライズソリューション:Wix API キーを使用する
読了時間:10分
Wix API キーは、ユーザーまたはアプリケーションを認証し、サイトやアカウントデータへのアクセスを許可するために生成できるコードです。
API キーは、エンタープライズダッシュボードの「設定」セクションで管理できます。新しいキーの生成、既存のキーのローテーションまたは複製、詳細と権限の編集、不要になったキーの削除などを行うことができます。
Wix API キーについて
アプリケーションプログラミングインターフェース(API)は、コンピューター間のリクエストと応答のやり取りに使用される通信プロトコルです。たとえば、メールアドレスとパスワードを使用して Wix アカウントにログインすると、API が資格情報を使用して Wix へのログイン権限を認証します。
API キーは、ユーザーまたはアプリケーションが自身を認証するために API に送信できるコード(文字列)です。API キーが有効な場合、API はそのデータへのアクセスを許可します。アクセスできる特定のデータは、API キーの権限セットに基づいて決まります。
![API キーの権限セットのスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/cc46b1fc-b850-4ddb-9a64-77374e4f8bde/5da6e096-0149-48a6-b5cd-c759803f4823.png)
Wix API キーを使用して Wix API を呼び出す
エンタープライズダッシュボードで生成した API キーを使用すると、Wix API を使用してアカウントおよびサイトのデータにアクセス・管理し、カスタム機能を構築することができます。
たとえば、ストアから商品リストを取得する、ストアに新商品を追加する、またはその新商品について SNS に自動的に投稿するといった操作を実行できます。
Wix API キーを生成する
エンタープライズダッシュボードの「設定」セクションで、サイトのデータにアクセスするための API キーを生成することができます。
重要:
- デフォルトでは、生成した各 API キーによってアカウント内のすべてのサイトにアクセスすることができます。これは、API キーがアカウントレベルで生成されるためです。
- セキュリティを強化するため、生成した各 API キートークンは作成時に一度だけ表示されます。
- 「API キーが生成されました」ポップアップを閉じた後、API キーのトークンを再度表示することはできません。今後アクセスできるよう、トークンは安全な場所に保管してください。
API キーを生成する方法:
- エンタープライズダッシュボードで「API キー」にアクセスします。
- 右上の「+API キーを生成する」をクリックします。
- 「キーの詳細」下に新しい API キーの名前を入力します。
- API キーに割り当てるアクセス権を選択します。
- アカウント内のすべてのサイトの ID を返す基本のアクセス権がデフォルトで選択されています。この選択を解除することはできません。
- セキュリティ確保のため、必要なアクセス権のみを追加してください。API セキュリティに関する詳細はこちら
- 「キーを生成する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを取得します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーを生成する」をクリックします。
![API キーを認証しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/6f0d936a-ea2b-4953-a9e7-cd80d022fcee/43fc7ca8-38cb-4f89-9f4b-bbf2301655c5.png)
- 「トークンをコピーして閉じる」をクリックします。
- トークンを安全な場所に保管します。
ヒント:
同じアクセス権を持つ別の API キーが必要な場合は、API キーをローテーションまたは API キーを複製することができます。
Wix API キーをローテーションする
API キーをローテーションして、同じ名前、説明、アクセス権を維持したまま、新しいトークンを作成することができます。API キーをローテーションすると、以前アクセス権を持っていたユーザーはそのキーを使用できなくなるため、新しいトークンを共有する必要があります。
重要:
- API キーをローテーションすると、それを使用していたユーザーやアプリケーションは即座にデータにアクセスできなくなります。
- API キーを更新した後は、以前のトークンを復元することはできません。
API キーをローテーションする方法:
- エンタープライズダッシュボードで「API キー」にアクセスします。
- 右上の「+API キーを生成する」をクリックします。
- ローテーションしたい API キー横の「その他のアクション」アイコン
をクリックします。
- 「ローテーション」を選択します。
![API キーをローテーションしているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/14f87ab8-0253-46fd-86e9-f2b2e43730e7/0ec62ca1-9886-4b1b-b188-9ddff3798b29.jpeg)
- ポップアップで「ローテーションする」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを取得します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーをローテーションする」をクリックします。
![ローテーションされた API キーを認証しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/8e01ae86-f2cd-46de-98a6-e897432e132b/3505349e-92ad-43d9-95e0-d6e33d9e6a90.png)
- 「トークンをコピーして閉じる」をクリックします。
- トークンを安全な場所に保管します。
Wix API キーを複製する
同じアクセス権を持つ別の API キーが必要な場合は、既存の API キーのいずれかを複製することができます。キーを複製した後、さらにカスタマイズする必要がある場合はその説明とアクセス権を編集することもできます。
重要:
- デフォルトでは、生成した各 API キーによってアカウント内のすべてのサイトにアクセスすることができます。これは、API キーがアカウントレベルで生成されるためです。
- セキュリティを強化するため、生成した各 API キートークンは作成時に一度だけ表示されます。
- 「API キーが生成されました」ポップアップを閉じた後、API キーのトークンを再度表示することはできません。今後アクセスできるよう、トークンは安全な場所に保管してください。
API キーを複製する方法:
- エンタープライズダッシュボードで「API キー」にアクセスします。
- 複製したい API キー横の「その他のアクション」アイコン
をクリックします。
- 「複製」を選択します。
![API キーを複製しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/7d9a7336-8cdb-4baf-ac85-5202c112f4e5/d3a2f5a5-ceb3-4d55-ba75-095e616d14b4.jpeg)
- 「キーの詳細」下に新しい API キーの新しい名前を入力します。
- (オプション)API キーに割り当てられているアクセス権を編集します。
- アカウント内のすべてのサイトの ID を返す基本のアクセス権がデフォルトで選択されています。この選択を解除することはできません。
- セキュリティ確保のため、必要なアクセス権のみを追加してください。詳細はこちら
- 「キーを生成する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを取得します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーを生成する」をクリックします。
![複製された API キーを確認しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/a1fb3439-ce2f-48b9-a15a-bfe32b671681/37d9a6dc-ed8e-4d41-92d9-ddbf267a4552.png)
- 「トークンをコピーして閉じる」をクリックします。
- キーは安全な場所に保管してください。
Wix API キーを編集する
API キーを作成した後は、「API キーを編集」ページで名前と権限を更新できます。
API キーを編集する方法:
- エンタープライズダッシュボードで「API キー」にアクセスします。
- 編集したい API キー横の「その他のアクション」アイコン
をクリックします。
- 「編集」を選択します。
![API キーを編集しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/a148730f-2d00-40dd-bf41-53552e7a94dc/b48bf585-1ef8-4692-8bd1-3ad3399d76bc.jpeg)
- API キーの名前またはアクセス権を編集します。
- 「保存して閉じる」をクリックします。
![API キーの変更を保存しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/c06ebd78-e7ae-42ab-89a0-3d5f5a4b6eaa/0a1cdb4c-3f03-4bfc-852b-8a7a35f630b7.jpeg)
- 「編集内容を保存する」をクリックして確定します。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを取得します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証して変更を保存する」をクリックします。
![API キーの変更を確認するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/bf59e42a-21f9-4117-88ad-3c27478fa97d/4da7435f-6306-4368-a833-719944cb787e.png)
Wix API キーを削除する
エンタープライズダッシュボードの「設定」セクションで、不要になった API キーを削除することができます。
重要:
- API キーのアクセス権を持つユーザーまたはアプリケーションは、キーを削除するとデータにアクセスできなくなります。
- 削除した API キーを復元することはできません。
API キーを削除する方法:
- エンタープライズダッシュボードで「API キー」にアクセスします。
- 削除したい API キー横の「その他のアクション」アイコン
をクリックします。
- 「削除」を選択します。
![API キーを削除しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/242ddc2c-8805-43be-907c-817fcac21897/05e9bc5e-b07d-43d9-b30a-c14475954416.jpeg)
- ポップアップで「削除する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを取得します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーを削除する」をクリックします。
![API キーの削除を確認するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/3ed69310-594f-41fe-adce-e794cdfd6157/2734c6fa-3ee9-4812-a93a-43a80c2ecb1e.png)
Wix API キーのアクセス権を選択する
API キーに割り当てる権限によって、そのキーを使用して API 呼び出しがアクセスできるデータの種類が制御されます。
たとえば、Wix ストアの権限を選択して、商品、注文、通貨を含むサイトのストアデータへのアクセスのみを許可することができます。
重要:
ほとんどの権限は、サイトデータへの読み取りおよび書き込みアクセス権を自動的に付与します。サイトデータへの必要以上のアクセスを許可しないように、API キーには必要な権限のみを割り当てることが重要です。権限と API キーのセキュリティに関する詳細はこちら
「API キー」ページで API キーの横にある「アクセス権を表示」をクリックすると、API キーの権限を確認できます。
![API キーの権限セットを表示しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/3c387ad6-1181-46da-89f8-fa7a3c0b494e/b7342b36-8db1-4ca9-8dc1-6daf0d82f344.jpeg)
また、アクセス権を追加または削除する必要がある場合は、いつでも API キーのアクセス権を編集することができます。
キーのアクセス権を編集する方法:
- エンタープライズダッシュボードで「API キー」にアクセスします。
- 編集したい API キー横の「その他のアクション」アイコン
をクリックします。
- 「編集」を選択します。
- 「アクセス権」下で API キーに割り当てる新しいアクセス権を選択します。
![API キーの権限セットのスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/3cdd297c-ee69-4caa-a121-d9ecb35fc629/5fab56e3-693a-4a04-9a9e-4558b463760e.png)
- 「保存して閉じる」をクリックします。
- ポップアップで「編集内容を保存する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを取得します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証して変更を保存する」をクリックします。
![API キーの権限セットへの変更を確認するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/4a1b597b-14c2-4ca0-9274-b10fed486afe/743b9e4c-f5bc-4295-91d3-77bb83b2afde.png)
アカウント ID を取得する
サイトレベルの API を使用するには、HTTP リクエストのヘッダーに Wix アカウント ID を含める必要があります。アカウント ID は、エンタープライズダッシュボードの「API キー」ページで取得できます。
アカウント ID を取得する方法:
- エンタープライズダッシュボードで「API キー」にアクセスします。
- 「アカウント ID」下の「ID をコピー」をクリックします。
![「API キー」ページでアカウント ID をコピーしているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2024/07/19/f9281631-1404-4a7d-9927-de4f7857cb6d/d30131e6-7d86-41bd-ad6d-0d8b87cd2228.png)
Wix API キーに関する詳しい情報: