Wix API キーを管理する
読了時間:9分
Wix API キーは、ユーザーまたはアプリケーションを認証し、サイトおよびアカウントのデータにアクセスするために生成できるコードです。
Wix API キーを使用して注文、商品、イベントなどのデータにアクセスし、独自のカスタム機能を構築してサードパーティ製アプリに接続しましょう。
この記事では、下記の項目について説明します:
Wix API キーを生成する
アカウント設定で、サイトのデータにアクセスするための API キーを生成することができます。
重要:
- デフォルトでは、生成した各 API キーによってアカウント内のすべてのサイトにアクセスすることができます。これは、API キーがアカウントレベルで生成されるためです。
- セキュリティを強化するため、生成した各 API キートークンは作成時に一度だけ表示されます。
- 「API キーが生成されました」ポップアップを閉じた後、API キーのトークンを再度表示することはできません。今後アクセスできるよう、トークンは安全な場所に保管してください。
API キーを生成する方法:
- アカウント設定で「API キー」にアクセスします。
- 「+API キーを生成する」をクリックします。
- 「キーの詳細」下に新しい API キーの名前を入力します。
- API キーに割り当てるアクセス権を選択します。
- アカウント内のすべてのサイトの ID を返す基本のアクセス権がデフォルトで選択されています。この選択を解除することはできません。
- セキュリティ確保のため、必要なアクセス権のみを追加してください。キーのアクセス権に関する詳細はこちら
- 「キーを生成する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを確認します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーを生成する」をクリックします。
![API キーを認証しているスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/2554b1cc-0e12-40cd-894d-d89326af0b4e/692eb4ee-2dfa-4361-a812-31767a0ed434.png)
- 「トークンをコピーして閉じる」をクリックします。
- トークンを安全な場所に保管します。
ヒント:
同じアクセス権を持つ別の API キーが必要な場合は、API キーをローテーションまたは API キーを複製することができます。
Wix API キーをローテーションする
API キーをローテーションして、同じ名前、説明、アクセス権を維持したまま、新しいトークンを作成することができます。API キーをローテーションすると、以前アクセス権を持っていたユーザーはそのキーを使用できなくなるため、新しいトークンを共有する必要があります。
重要:
- API キーをローテーションすると、それを使用していたユーザーやアプリケーションは即座にデータにアクセスできなくなります。
- API キーを更新した後は、以前のトークンを復元することはできません。
API キーをローテーションする方法:
- アカウント設定で「API キー」にアクセスします。
- ローテーションしたい API キー横の「その他のアクション」アイコン
をクリックします。
- 「ローテーション」を選択します。
![API キーをローテーションするスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/88184a17-bb76-43c5-aa85-86f6c14193f8/b86c7bf9-bf83-4ce4-bfa4-b445e73311a7.jpeg)
- ポップアップで「ローテーションする」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを確認します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーをローテーションする」をクリックします。
![ローテーションされた API キーを認証するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/d85caa39-e0a7-4309-9175-f911793627f2/488ac84f-4cab-4a49-b009-e3d24e6b4ca5.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/2023/02/17/0ebbe5d6-3bb8-41dc-b89c-9865941d9978/090508b9-0872-4349-bbec-ee21d2816bd2.jpeg)
- 「キーの詳細」下に新しい API キーの新しい名前を入力します。
- (オプション)API キーに割り当てられているアクセス権を編集します。
- アカウント内のすべてのサイトの ID を返す基本のアクセス権がデフォルトで選択されています。この選択を解除することはできません。
- セキュリティ確保のため、必要なアクセス権のみを追加してください。詳細はこちら
- 「キーを生成する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを確認します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーを生成する」をクリックします。
![複製された API キーを確認するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/77ae5be3-6993-42eb-a86d-cb40e43c3777/9d9b94b9-d9eb-4998-8263-24b0a34a4547.png)
- 「トークンをコピーして閉じる」をクリックします。
- キーは安全な場所に保管してください。
Wix API キーを編集する
API キーを作成した後は、「API キーを編集」ページで名前と権限を更新できます。
API キーを編集する方法:
- アカウント設定で「API キー」にアクセスします。
- 編集したい API キー横の「その他のアクション」アイコン
をクリックします。
- 「編集」を選択します。
![API キーを編集するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/7ec830d2-4f63-483e-b54d-a76d25ebc4b7/784535f1-554a-4a8b-a3fd-9fea83d77b99.jpeg)
- API キーの名前またはアクセス権を編集します。
- 「保存して閉じる」をクリックします。
![API キーの変更を保存するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/a219cf2b-d1c1-481d-95bc-82c06a74512d/a704e124-56fc-4c3e-a9c8-a2ae627be964.jpeg)
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを確認します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証して変更を保存する」をクリックします。
![API キーの変更を確認するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/4d5b9fe8-f132-4e92-8a11-6e4e467e3072/0474c498-a842-4d96-ab0e-dd795f35cfb4.png)
Wix API キーを削除する
不要になった API キーはいつでも削除できます。
重要:
- API キーのアクセス権を持つユーザーまたはアプリケーションは、キーを削除するとデータにアクセスできなくなります。
- 削除した API キーを復元することはできません。
API キーを削除する方法
- アカウント設定で「API キー」にアクセスします。
- 削除したい API キー横の「その他のアクション」アイコン
をクリックします。
- 「削除」をクリックします。
![API キーを削除するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/a4f60c50-c0d3-44fd-8ed8-545fec47d3a7/42aac45f-7949-4889-baa9-8d176dcda0ce.jpeg)
- ポップアップで「削除する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを確認します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証してキーを削除する」をクリックします。
![API キーの削除を確認するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/8072fdfd-58b4-4e6a-8978-d116db3450ab/4f3b1122-6a02-4320-be04-e1c64a9be448.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/2023/02/17/881cfa59-6811-45d0-aaba-390a316c2a95/3c3635a6-a26c-4907-a93c-ec0c44884c48.jpeg)
また、アクセス許可を追加または削除する必要がある場合は、いつでも API キーのアクセス許可を編集することができます。
キーのアクセス権限を編集する方法:
- アカウント設定で「API キー」にアクセスします。
- 編集したい API キー横の「その他のアクション」アイコン
をクリックします。
- 「編集」を選択します。
- 「アクセス権」下で API キーに割り当てる新しいアクセス権を選択します。
![API キーの権限セットのスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/16e3d304-f7a2-4446-b3f7-e8a624d1c417/4a276231-92c3-41c2-86ee-2e5d8686746a.png)
- 「保存して閉じる」をクリックします。
- ポップアップで「編集内容を保存する」をクリックします。
- 「コードを送信」をクリックして、アカウントにリンクされているメールアドレスに 6桁の認証コードを送信します。
- メールを開いて認証コードを確認します。
- 「アカウントを認証」ポップアップにコードを入力します。
- 「認証して変更を保存する」をクリックします。
![API キーの権限セットへの変更を確認するスクリーンショット](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/43afd84c-813c-43a2-baab-131b6878accd/2023/02/17/6da21420-07f5-456f-af8c-86a6b47e332c/457cb9ef-7a6e-469a-9c10-8af32affb05d.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/2023/02/17/ccf4bf44-ad7d-42ac-92a9-a06c980ea04c/fde0a62c-1426-4cf2-a25e-e31b6dc6a9b1.png)
Wix API キーに関する詳しい情報: