API 인증키 관리는 외부 시스템과 셀러루트 API를 안전하게 연동하기 위해 Access Key와 Secret Key를 발급하고 관리하는 기능입니다.
발급된 API 인증키의 만료일시는 발급일로부터 1년입니다.
더이상 사용하지 않는 인증키는 삭제하거나 사용여부를 ‘미사용’으로 변경해 주세요.
인증키가 만료된 경우에는 Secret Key를 재발급해야 정상적으로 API를 사용할 수 있습니다.
발급된 API 인증키의 만료일시는 발급일로부터 1년입니다.
더이상 사용하지 않는 인증키는 삭제하거나 사용여부를 ‘미사용’으로 변경해 주세요.
인증키가 만료된 경우에는 Secret Key를 재발급해야 정상적으로 API를 사용할 수 있습니다.
1. API 인증키 관리 화면으로 이동
상단 메뉴에서 MY - API 인증키 관리를 클릭해 ‘API 인증키 관리’ 화면으로 이동한 뒤, ‘신규 발급’ 버튼을 눌러 주세요.
2. API 정보 입력 후 신규 발급
API 이름 등 필요한 정보를 입력한 뒤 ‘신규발급’을 진행해 주세요.
허용 IP 목록은 API를 호출하는 외부 시스템의 서버 IP를 확인할 수 있는 경우 입력해 주세요.
여러 개를 등록할 때는 쉼표(,)로 구분해서 입력할 수 있습니다.
3. 발급된 Access Key와 Secret Key로 API 연동
신규 발급이 완료되면 Access Key와 Secret Key가 생성됩니다.
발급된 키를 외부 시스템에 설정하면 셀러루트 API 연동을 진행할 수 있습니다.
인증키의 유효기간은 발급일로부터 1년입니다.
4. 인증 정보 관리에서 수정·삭제·Secret Key 재발급
API 정보 수정, 삭제, Secret Key 재발급이 필요하면 ‘인증 정보 관리’ 링크를 클릭해 주세요.
더이상 사용하지 않는 인증키는 삭제하거나 사용여부를 ‘미사용’으로 변경해 관리할 수 있습니다.
이미 만료된 인증키는 Secret Key 재발급 후 다시 연동해 주세요.
5. 인증키를 이용해서 API 테스트를 진행할 수 있습니다.
Access Key와 Secret Key를 입력하고 Request Body를 작성해서 실제 API를 테스트해볼 수 있습니다.
테스트로 등록한 신청서는 꼭 삭제해주세요.
Secret Key는 외부에 노출되지 않도록 주의해 주세요. 운영 중인 서버 IP가 변경되었거나 키가 만료된 경우에는 인증 정보 관리에서 즉시 수정 또는 재발급해 주세요.
자주 묻는 질문
Q. 허용 IP 목록은 꼭 입력해야 하나요?
필수는 아닙니다. 다만 API를 호출하는 외부 시스템의 서버 IP를 확인할 수 있다면 입력하는 것을 권장합니다. 허용된 IP만 API 호출이 가능하도록 제한할 수 있어 보안 관리에 도움이 됩니다. 여러 개의 IP를 등록할 때는 쉼표(,)로 구분해 입력해 주세요.
Q. Access Key와 Secret Key는 어디에 사용하나요?
발급된 Access Key와 Secret Key는 외부 시스템에서 루트스마일 API를 호출할 때 사용하는 인증 정보입니다. 연동하려는 시스템의 API 설정 화면이나 서버 프로그램에 입력해 사용하면 됩니다. 특히 Secret Key는 외부에 노출되지 않도록 안전하게 관리해 주세요.
Q. 발급한 API 인증키가 만료되었거나 더이상 사용하지 않으면 어떻게 해야 하나요?
인증키의 만료일시는 발급일로부터 1년입니다. 만료된 경우에는 Secret Key를 재발급해 다시 연동해야 하며, 더이상 사용하지 않는 인증키는 삭제하거나 사용여부를 ‘미사용’으로 변경해 관리해 주세요.