토스쇼핑 Open API 연동기 2편: Jukebox WordPress에서 OAuth 인증과 Health API 테스트하기

토스쇼핑 Open API 연동기 2편입니다. 1편에서 발급받은 API 키를 실제 Jukebox WordPress 서버에 연결해, OAuth 토큰 발급과 Health API 호출을 테스트한 과정과 결과를 기록합니다.

1편 요약: API 키 발급까지의 과정

1편, 토스쇼핑 Open API 키 발급기에서는 토스쇼핑 Open API 발급 신청부터 승인, 케미클라우드 서버의 출발지 IP 확인, curl -4 https://api.ipify.org를 이용한 IP 재확인, 출발지 IP 등록, 그리고 API 키 발급까지의 과정을 다뤘습니다.

키를 발급받은 것만으로는 실제 서버에서 API가 정상적으로 동작하는지 알 수 없습니다. 그래서 1편에 이어 이번 2편에서는 발급받은 키를 실제 Jukebox 서버에 연결해, 인증과 기본 API 호출이 정상적으로 이루어지는지부터 확인했습니다.

상품 조회보다 연결 테스트를 먼저 한 이유

처음부터 상품 자동화 전체를 한 번에 구현하는 대신, 다음과 같이 범위를 좁혀 단계적으로 테스트를 진행했습니다.

이번 글에서는 이 중 앞부분인 인증 및 기본 연결 확인까지 진행한 내용을 다룹니다. 토스 쉐어링크 Open API 공식 문서에서도 액세스 토큰 발급 이후 곧바로 GET /openapi/health로 인증과 IP 허용 여부를 확인하는 단계를 안내하고 있어, 이 순서를 그대로 따랐습니다.

테스트 플러그인 제작

Jukebox WordPress에서 토스쇼핑 API 서버와 실제로 통신할 수 있는 환경이 필요해, 1차 테스트용 플러그인을 간단히 제작했습니다. 플러그인 자체의 세부 소스코드보다 중요한 것은, WordPress 서버에서 토스쇼핑 Open API 서버와 실제로 통신하는 테스트 환경을 만들었다는 점입니다. 이 플러그인을 통해 이후의 OAuth 인증과 Health API 호출을 순서대로 실행했습니다.

OAuth 토큰 발급 테스트

1편에서 발급받은 API 키를 이용해 OAuth 인증을 실행했고, 실제로 토큰 발급에 성공했습니다.

결과: OAuth 인증 → 토큰 발급 성공

실제 토큰 값이나 API 키 값은 보안상 본문에 포함하지 않습니다.

Health API 호출 결과

OAuth 인증 이후, 연결 상태를 확인하기 위해 Health API를 호출했습니다. 실제 응답 결과는 다음과 같습니다.

각 값의 의미를 과도하게 확대 해석하지 않고, 실제 응답값이 정상적으로 반환됐다는 사실 자체에 집중해 기록합니다. 즉, Jukebox 서버에서 토스쇼핑 Open API 인증을 위한 OAuth 토큰 발급이 정상적으로 이루어졌고, Health API 역시 정상 응답을 반환했습니다.

이번 테스트로 확인된 것

이번 1차 테스트를 통해 다음 흐름이 정상적으로 연결됐다는 것을 확인했습니다.

이번 단계에서는 API 인증과 기본 연결 상태까지 확인했습니다. 실제 상품 정보 조회, 상품 목록 조회, 상품 데이터 자동 수집, WordPress 자동 저장, Jukebox 상품 선별 자동화, SNS 콘텐츠 자동 생성, 주문 이벤트·콜백 처리 등은 아직 테스트하지 않았습니다.

아직 남은 테스트: 상품 API 조회

다음 단계는 실제 상품 API를 호출해 토스쇼핑 상품 정보를 Jukebox 서버에서 가져올 수 있는지 확인하는 것입니다. 이 단계에서 실제로 어떤 상품 정보가 제공되는지는 아직 테스트하지 않았기 때문에 미리 추측하지 않습니다.

상품 조회 테스트가 성공하면 이후에는 상품 정보 수집, Jukebox 상품 선별에 필요한 데이터 활용, 상품 콘텐츠 생성에 필요한 데이터 활용, 향후 자동화 가능성 등을 검토해볼 수 있습니다. 다만 아직 구현하지 않은 기능을 구현 완료한 것처럼 표현하지는 않습니다.