토스쇼핑 Open API 키 발급 후기 — 승인부터 케미클라우드 서버 IP 확인까지

작성자:

Jukebox에서 토스쇼핑 상품 정보를 자동으로 활용하기 위해 토스쇼핑 쉐어링크 Open API 연동을 신청했다. 심사를 거쳐 승인을 받은 뒤, API 연동 키를 만들기 전에 API를 호출할 서버의 출발지 IP가 필요하다는 안내를 확인했다. 케미클라우드 서버 정보와 curl 명령으로 출발지 IP를 확인하고, 그 IP로 API 키를 발급받기까지의 과정을 기록한다.

토스쇼핑 Open API 연동을 검토한 이유

Jukebox에서는 토스쇼핑 상품 정보를 자동으로 가져와 활용할 방법을 찾고 있었다. 토스쇼핑에서는 제휴사가 상품을 소개하고 그 성과를 수익으로 정산받을 수 있도록 쉐어링크 Open API를 제공하고 있어, 이 API 연동을 검토하게 되었다.

다만 이번 글에서 다루는 범위는 명확하다. 상품을 조회하거나 쉐어링크를 발급하는 실제 호출 단계까지는 아직 진행하지 않았고, 연동 신청부터 API 키를 발급받기까지의 과정만 기록한다.

Open API 사용 신청과 승인

토스쇼핑 Open API는 누구나 바로 호출할 수 있는 구조가 아니라, 사용 신청 후 심사를 거쳐 승인을 받아야 하는 승인제로 운영되고 있었다. 신청을 진행한 뒤 별도의 심사 과정을 거쳤고, 이후 연동 승인이 완료되었다는 안내를 받았다.

API 키를 만들기 전에 필요했던 것 — 서버 출발지 IP

승인이 완료된 화면에는 다음과 같은 안내 문구가 표시되었다.

“Open API 연동 승인 완료 — 이제 API 연동 키를 만들 수 있어요. 키를 만들 때 API를 호출할 서버의 출발지 IP가 필요해요.”

즉, API 키를 발급받기 전에 실제로 API를 호출할 서버의 공인 IP를 먼저 확인해 두어야 하는 절차였다. Jukebox WordPress는 케미클라우드(ChemiCloud) 서버에서 운영하고 있어, 이 서버의 출발지 IP를 확인하는 작업이 필요했다.

케미클라우드 서버 정보에서 공유 IP 확인

먼저 케미클라우드 호스팅 관리 화면에서 서버 정보를 확인했다. 서버 정보 항목에는 공유 IP 주소가 141.164.51.xxx로 표시되어 있었다.

터미널에서 외부 인식 IP 재확인

관리 화면에 표시된 IP와 실제로 외부에서 이 서버가 어떤 IP로 인식되는지가 다를 수 있다는 점이 걸렸다. 그래서 서버 터미널에 접속해 다음 명령으로 외부 기준 IPv4 주소를 다시 확인했다.

실행 명령curl -4 https://api.ipify.org
반환된 IP141.164.51.xxx

관리 화면에서 확인한 공유 IP와 curl 명령으로 확인한 외부 인식 IP가 동일하게 나와, 이 IP를 API 호출 서버의 출발지 IP로 사용해도 된다는 확신을 가질 수 있었다.

이번 확인 작업 정리
  • 서버: 케미클라우드(ChemiCloud)에서 운영 중인 Jukebox WordPress 서버
  • 확인 방법: 호스팅 관리 화면의 서버 정보 + 서버 터미널의 curl -4 https://api.ipify.org
  • 확인된 출발지 IP: 141.164.51.xxx (두 방법 모두 동일하게 확인)

API 키 발급 완료

출발지 IP를 확인한 뒤, 이 IP를 등록해 토스쇼핑 Open API 키를 발급받았다. API 키 자체의 값은 외부에 노출되면 안 되는 정보이므로 이 글에는 별도로 기록하지 않으며, API 키를 발급받았다는 사실까지만 남긴다.

아직 진행하지 않은 부분

API 키를 발급받았다고 해서 상품 조회나 쉐어링크 발급 같은 실제 기능까지 확인이 끝난 것은 아니다. 이번 과정에서 실제로 확인한 것과 아직 확인하지 않은 것을 구분하면 다음과 같다.

확인된 것Open API 사용 승인, 서버 출발지 IP 확인, API 키 발급
아직 확인하지 않은 것발급받은 키로 실제 API를 호출해 상품을 조회하는 단계, 상품 자동 수집·자동 게시 등 자동화 범위 전체

따라서 이 API 키로 어떤 자동화까지 가능할지는 이번 글에서 단정하지 않는다. 그 부분은 실제로 API를 호출해 본 뒤에 별도로 기록할 예정이다.

다음 단계

다음으로는 발급받은 API 키를 실제 Jukebox 서버에서 사용해 API 연결을 테스트하는 과정을 진행할 예정이다. 실제 호출이 정상적으로 이루어지는지, 그리고 어떤 데이터를 받아올 수 있는지는 그 다음 글에서 다룰 계획이다.

자주 묻는 질문

토스쇼핑 Open API는 누구나 바로 사용할 수 있나요?

아니다. 사용 신청 후 심사를 거쳐 승인을 받아야 API 연동 키를 만들 수 있는 승인제로 운영되고 있다.

API 키를 만들 때 왜 서버 IP가 필요한가요?

API를 호출할 서버의 출발지 IP를 미리 등록해 두어야 하기 때문이다. 등록된 IP에서 온 요청만 API 접근이 허용되는 구조로 안내되어 있었다.

서버의 IP는 어떻게 확인하나요?

이번 작업에서는 케미클라우드 호스팅 관리 화면의 서버 정보와, 서버 터미널에서 실행한 curl -4 https://api.ipify.org 명령 두 가지 방법으로 확인했다. 두 방법의 결과가 동일한지 비교해 보면 더 확실하다.

API 키를 발급받으면 바로 상품 데이터를 자동으로 가져올 수 있나요?

이번 글의 범위에서는 아직 확인하지 않았다. API 키 발급까지만 진행했고, 실제 API 호출과 데이터 활용은 다음 단계에서 테스트할 예정이다.

참고한 공식 문서

이번 연동 과정에서는 다음 토스쇼핑 쉐어링크 Open API 공식 문서를 참고했다.