Wix API 키 관리하기

7 분 분량
Wix API 키는 사용자 또는 애플리케이션을 승인하고 사이트 및 계정 데이터에 대한 액세스를 부여하기 위해 생성할 수 있는 코드입니다.
Wix API 키를 사용해 주문, 제품, 이벤트와 같은 데이터에 액세스해 나만의 사용자 지정 기능을 구축하고 타사 서비스에 연결하세요. 

Wix API 키 생성하기

계정 설정에서 사이트 데이터에 액세스하기 위한 API 키를 생성할 수 있습니다. 
중요!
  • 기본적으로 생성한 각 API 키는 계정의 모든 사이트에 액세스할 수 있습니다. 이는 API 키가 계정 수준에서 생성되기 때문입니다. 
  • 보안 강화를 위해 생성한 각 API 키 토큰은 생성 시 한 번만 표시됩니다. 
  • API 키 생성 완료 팝업을 닫은 후에는 API 키의 토큰을 다시 확인할 수 없습니다. 향후 토큰에 액세스할 수 있도록 토큰을 안전한 위치에 저장하세요.

API 키를 생성하려면:

  1. 계정 설정에서 API 키로 이동합니다.
  2. API 키 생성을 클릭합니다.
  3. 키 정보 아래에 새 API 키 이름을 입력합니다. 
  4. API 키에 지정할 권한을 선택합니다. 
    • 계정에 있는 모든 사이트의 ID를 반환하는 기본 권한이 기본적으로 선택되어 있습니다. 이는 선택을 해제할 수 없습니다.
    • 보안을 위해 필요한 권한만 추가합니다. 자세히 보기
  5. 키 생성을 클릭합니다.
  6. 코드 발송을 클릭해 계정에 연결된 이메일 주소로 6자리 인증 코드를 발송합니다. 
  7. 이메일에서 인증 코드를 받습니다.
  8. 계정 인증 팝업에 코드를 입력합니다.
  9. 키 인증 및 생성을 클릭합니다.
API 키 인증 스크린샷
  1. 토큰 복사 및 닫기를 클릭합니다. 
  2. 토큰을 안전한 위치에 저장합니다. 
도움말:
동일한 권한을 가진 다른 API 키가 필요한 경우, API 키를 교체하거나 API 키를 복제할 수 있습니다.

Wix API 키 교체하기

API 키를 교체해 동일한 이름, 설명, 권한을 유지하면서 새 토큰을 생성할 수 있습니다. API 키를 교체하면, 이전에 액세스 권한이 있는 모든 사용자가 더 이상 사용할 수 없으며, 새 토큰을 공유해야 합니다.
중요!
  • API 키를 교체하면 이전에 이를 사용한 모든 사용자 또는 애플리케이션이 즉시 데이터에 액세스할 수 없습니다. 
  • API 키를 교체한 후에는 이전 토큰을 복구할 수 없습니다.
도움말:
  • 대부분의 경우, API 키를 복제하고, API 호출에 새 토큰을 추가하고, 새 토큰이 필요한 팀원과 공유하고, 이전 API 키를 삭제하는 것이 좋습니다. 
  • 이는 키를 사용하는 API가 서비스가 중단되지 않도록 합니다. 
  • 키가 손상되었다고 생각되는 경우 API 키를 교체만 하는 것이 좋습니다. 

API 키를 교체하려면:

  1. 계정 설정에서 API 키로 이동합니다.
  2. 교체하고자 하는 API 키 옆의 추가 작업 아이콘을 클릭합니다.
  3. 교체를 선택합니다.
API 키 교체 스크린샷
  1. 팝업창에서 키 교체를 클릭합니다.
  2. 코드 발송을 클릭해 계정에 연결된 이메일 주소로 6자리 인증 코드를 발송합니다. 
  3. 이메일에서 인증 코드를 받습니다.
  4. 계정 인증 팝업에 코드를 입력합니다.
  5. 키 유효성 검사 및 교체를 클릭합니다.
교체된 API 키 유효성 검사 스크린샷
  1. 토큰 복사 및 닫기를 클릭합니다. 
  2. 토큰을 안전한 위치에 저장합니다. 

Wix API 키 복제하기

동일한 권한을 가진 다른 API 키가 필요한 경우, 기존 API 키 중 하나를 복제할 수 있습니다. 키를 복제한 후에는 추가로 사용자 지정해야 하는 경우 설명 및 권한을 편집할 수도 있습니다.
중요!
  • 기본적으로 생성한 각 API 키는 계정의 모든 사이트에 액세스할 수 있습니다. 이는 API 키가 계정 수준에서 생성되기 때문입니다. 
  • 보안 강화를 위해 생성한 각 API 키 토큰은 생성 시 한 번만 표시됩니다. 
  • API 키 생성 완료 팝업을 닫은 후에는 API 키의 토큰을 다시 확인할 수 없습니다. 향후 토큰에 액세스할 수 있도록 토큰을 안전한 위치에 저장하세요.

API 키를 복제하려면:

  1. 계정 설정에서 API 키로 이동합니다.
  2. 복제하고자 하는 API 키 옆의 추가 작업 아이콘을 클릭합니다.
  3. 복제를 선택합니다.
API 키 복제 스크린샷
  1. 키 정보 아래 새 API 키의 새 이름을 입력합니다. 
  2. (선택사항) API 키에 지정된 권한을 편집합니다. 
    • 계정에 있는 모든 사이트의 ID를 반환하는 기본 권한이 기본적으로 선택되어 있습니다. 이는 선택을 해제할 수 없습니다.
    • 보안을 위해 필요한 권한만 추가합니다. 자세히 보기
  3. 키 생성을 클릭합니다.
  4. 코드 발송을 클릭해 계정에 연결된 이메일 주소로 6자리 인증 코드를 발송합니다. 
  5. 이메일에서 인증 코드를 받습니다.
  6. 계정 인증 팝업에 코드를 입력합니다.
  7. 키 인증 및 생성을 클릭합니다.
복제된 API 키 인증 스크린샷
  1. 토큰 복사 및 닫기를 클릭합니다.
  2. 키를 안전한 위치에 보관합니다. 

Wix API 키 편집하기

API 키 편집 페이지에서 API 키를 생성한 후, 그 이름 및 권한을 업데이트할 수 있습니다. 
중요!
승인된 모든 팀원은 계정의 API 키를 편집할 수 있습니다. API 키를 편집할 수 있는 사용자를 변경하려면, 사이트의 역할 및 권한 또는 Wix Studio 워크스페이스의 팀 탭으로 이동합니다.

API 키를 편집하려면:

  1. 계정 설정에서 API 키로 이동합니다.
  2. 편집하고자 하는 API 키 옆의 추가 작업 아이콘을 클릭합니다.
  3. 편집을 선택합니다.
API 키 편집 스크린샷
  1. API 키의 이름 또는 권한을 편집합니다.
  2. 저장 및 닫기를 클릭합니다.
API 키 변경 사항을 저장하는 스크린샷
  1. 코드 발송을 클릭해 계정에 연결된 이메일 주소로 6자리 인증 코드를 발송합니다. 
  2. 이메일에서 인증 코드를 받습니다.
  3. 계정 인증 팝업에 코드를 입력합니다.
  4. 인증 및 변경 사항 저장을 클릭합니다.
API 키 변경 사항을 확인하는 스크린샷

Wix API 키 삭제하기

더 이상 필요하지 않은 API 키는 언제든지 삭제할 수 있습니다. 
중요!
  • API 키를 삭제하면 이전에 API 키에 액세스할 수 있던 모든 사용자 또는 애플리케이션이 데이터에 액세스할 수 없습니다. 
  • API 키를 삭제한 후에는 복구할 수 없습니다.

API 키를 삭제하려면

  1. 계정 설정에서 API 키로 이동합니다.
  2. 삭제하고자 하는 API 키 옆의 추가 작업 아이콘을 클릭합니다.
  3. 삭제를 선택합니다.
API 키 삭제 스크린샷
  1. 팝업에서 삭제를 클릭합니다.
  2. 코드 발송을 클릭해 계정에 연결된 이메일 주소로 6자리 인증 코드를 발송합니다. 
  3. 이메일에서 인증 코드를 받습니다.
  4. 계정 인증 팝업에 코드를 입력합니다.
  5. 키 인증 및 삭제를 클릭합니다.
API 키 삭제를 확인하는 스크린샷

Wix API 키 권한 선택하기

API 키에 지정하는 권한은 키를 사용해 API가 액세스할 수 있는 데이터의 종류를 제어합니다.
예를 들어, Wix 쇼핑몰 권한을 선택해 제품, 주문, 통화를 포함한 사이트 쇼핑몰 데이터에 대한 액세스만 허용하도록 할 수 있습니다.
중요!
대부분의 권한은 사이트 데이터에 대한 읽기 및 쓰기 액세스 권한을 자동으로 부여합니다. 사이트 데이터에 필요 이상으로 액세스 권한을 부여하지 않도록 필요한 권한만 API 키에 지정하는 것이 중요합니다. 권한 및 API 키 보안에 대한 자세한 도움말을 확인하세요.
API 키 페이지에서 API 키의 권한 옆 권한 표시를 클릭해 확인할 수 있습니다. 
API 키 권한 세트를 확인하는 GIF
권한을 추가하거나 제거해야 하는 경우에는 언제든지 API 키의 권한을 편집할 수 있습니다. 

키 권한을 편집하려면:

  1. 계정 설정에서 API 키로 이동합니다.
  2. 편집하고자 하는 API 키 옆의 추가 작업 아이콘을 클릭합니다.
  3. 편집을 선택합니다.
  4. 권한 아래에서 API 키에 지정할 새 권한을 선택합니다.
API 키 권한 세트 스크린샷
  1. 저장 및 닫기를 클릭합니다.
  2. 팝업창에서 변경사항 저장을 클릭합니다.
  3. 코드 발송을 클릭해 계정에 연결된 이메일 주소로 6자리 인증 코드를 발송합니다. 
  4. 이메일에서 인증 코드를 받습니다.
  5. 계정 인증 팝업에 코드를 입력합니다.
  6. 인증 및 변경 사항 저장을 클릭합니다.
API 키의 권한 세트 변경 사항을 확인하는 스크린샷

계정 ID 가져오기

사이트 수준 API를 사용하려면, HTTP 요청 헤더에 Wix 계정 ID를 포함해야 합니다. 계정 설정의 API 키 페이지에서 계정 ID를 확인할 수 있습니다. 

계정 ID를 확인하려면:

  1. 계정 설정에서 API 키로 이동합니다.
  2. 계정 ID 아래에서 ID 복사를 클릭합니다.
API 키 페이지에서 계정 ID를 복사하는 스크린샷

Wix API 키 사용에 대해 더 자세히 알고 싶다면,
API 키를 사용해 요청 구축하기에 대한 자세한 도움말을 확인하세요.