테마
API 사용하기
식스샵 프로 플랫폼에서 제공하는 API를 앱에 연동해 사용할 수 있어요.
API 호출을 위한 엑세스 키 획득
식스샵 API를 사용하기 위해선 엑세스 키(Access Key)가 필요해요.
앱 개발자 센터 내 앱 동작 페이지의 앱 엑세스 키(Access Key) 획득 방식 설정에서 앱에서 엑세스 키를 획득하는 방식을 설정할 수 있어요.
서버 호출(POST) 전달
- 앱이 스토어에 설치되면
POST요청을 통해 앱 서버로 엑세스 키가 전달돼요. - 보안상 가장 안전한 방식이고 권장하는 획득 방식이에요.
- 자세한 흐름은 설치 및 삭제 요청 처리 문서를 함께 참고해주세요.
앱 사용자 직접 전달
- 스토어 운영자가 엑세스 키를 직접 복사하고 앱에 전달(앱 관리 UI에 붙여넣기 등)하는 방식이에요.
- 스토어 운영자는 스토어에 앱을 설치한 이후, 앱 관리 페이지의 API 인증키 보기 버튼으로 엑세스 키를 확인할 수 있어요.
- 운영자가 복사하고 전달하는 과정에서 엑세스 키 유출 가능성이 있어 보안상 권장하지 않는 방식이에요.
- 주로 비공개 앱인 경우나 앱 개발 및 테스트 과정에서 필요에 따라 사용해요.
- 공개 앱에서 이 방식을 사용한 경우, 특수한 사유 외에는 앱스토어 심사에서 반려될 수 있어요.
엑세스 키 관리
전달된 엑세스 키는 설치한 스토어 별로 각각 다른 키가 발급되고, 앱에서는 엑세스 키를 설치한 스토어 별로 스토어 ID와 함께 저장하고 관리해야 해요.
🚨 엑세스 키는 비밀번호처럼 다루고 유출에 주의해주세요
유출된 엑세스 키가 악용되면 앱의 권한으로 스토어가 어뷰징될 수 있어요.
만약 유출이 의심되는 경우, 식스샵 고객센터 또는 파트너 채널을 통해 상황을 알려주세요.
API 호출하기
앱에서 설치된 스토어의 엑세스 키를 확보했다면, 식스샵 프로 플랫폼에서 제공하는 API를 호출해 사용할 수 있어요.
yaml
# API Endpoint
https://api.sixshop.io/*
# Headers
Authorization-Core: <ACCESS_KEY> # 앱 엑세스 키
SS-Store-ID: <STORE_ID> # 스토어 ID제공 중인 API 목록
제공 중인 API 목록과 설명은 다음의 문서들을 참고해주세요.
