[API] 카페24 API TOKEN 발급받고 이용하기

 

API를 겉핥기 한 것이 내 업보다....

백엔드와 DEVOps를 담당하던 사수가 사라지고 API를 확인하고 JSON 파일로 변환하거나

서버 데이터베이스에 저장하거나 하는 일이 전부 멈춰버렸는데

사업은 굴러가고 있으니 울며 겨자먹기로 퍼블리싱+프론트로 들어온 내가 바닥부터 뒤져가면서 해야 하는 상황....

일단은 API를 보려면 인증을 받아야 하는 것은 알고 있으나 이 인증부터 어떻게 받아내야하는지 천천히 기록하면서 외워야겠다.

 

 

 

---

 

 

문제상황 파악

 

 

 

✅ 현재 회사의 서버 상황

• AWS EC2를 사용
• 데이터베이스는 RDS
• node.js와 express.js를 이용
• nginx서버를 구동하고 있다.

 

 

 

✅ 지금 발생한 문제

• 펀딩이나 공구의 경우 카페24 모듈 내에 별도의 스크립트를 삽입하여
  현재까지 몇 명이 구매했는지 마감까지 며칠이 남았는지 표시하는 UI를 띄우고 있다.
• 해당 기능을 이용하기 위해서는 카페24 쇼핑몰관리자를 이용해 쇼핑몰 진열 모듈을 사용해 진열한다
  (MD팀이 진행)
• 개발팀은 판매일정과 할인율 등의 정보를 전달받아 일정 시작과 동시에
  MySQL 쿼리를 이용해 데이터베이스 테이블에 insert 한다.
• 테이블 컬럼 중 판매량 카운트 정보는 서버에서 10분에 1번씩 업데이트한다. (node.js cron 이용)
• 현재 이 판매량 카운트 정보가 데이터베이스에 업데이트가 안되는 상황

 

 

따라서 카페24 API 사용법을 배워서 이 문제를 해결해야 한다 ..... 😥 

 

 

---

 

그럼 일단 해결해보자

 

1️⃣ 일단 API 데이터로 판매량 정보가 정확하게 잡히고 있는지 봐야 한다.

 

당연히 브라우저에 API 주소를 그냥 입력하면 절대 안된다.

외부에 노출하는 값도 아니고 쇼핑몰이 개별적으로 관리하는 데이터들이기 때문에 (회원수, 주문자수, 반품수 등)

서버에서 돌리거나 (이걸 할 줄 모르는 원죄가 있다.)

POSTMAN 통해서 확인하기로 했다. 

 

 

 

2️⃣ POSTMAN을 설치하자

 

POSTMAN포스트맨은 API를 조회하는 것을 편하게 테스트해보기 위해 사용하는 프로그램이다.

이 프로그램 사용법은 구글링 하면 잘 나와있지만 

나는 카페24를 API를 조회하기 때문에 카페24 개발자센터의 POSTMAN 활용방법 문서를 보기로 했다.

 

공식 홈페이지에서 데스크탑용 프로그램을 다운받아준다.

 

 

 

3️⃣ 쇼핑몰 ADMIN어드민 정보 받아오기

 

나의 경우 사수가 API를 사용하기 위한 앱을 이미 개발해둔 상태여서 토큰만 발급받아주면 되었는데,

처음부터 시작하는 사람들을 위해 다시 한 번 카페24 개발자센터의 문서를 첨부한다. 

API는 카페24에서 만들어서 뿌려주지만 어떤 쇼핑몰에서 이용하는지 ID를 발급받는 과정이 필요하다.

 

이 ID를 발급받는 과정을 Oauth 인증이라고 하는데 

따라서 필수정보를 등록해준다. 이것도 문서를 첨부합니다..

이 문서를 통해 Client ID와 Client Secret Key 등을 발급받게 된다. 

이제 API를 눈으로 보기 위해서는 액세스 토큰을 발급받아야 한다.

 

이 과정은 연습용으로 만들어 둔 개인 쇼핑몰을 통해서 한 번 더 자세하게 포스팅 하겠음!!!

 

아무튼 이 액세스 토큰까지 발급받으면 모든 ID, KEY, TOKEN 등을 한 곳에 기록해둔다.

 

 

 

4️⃣ POSTMAN포스트맨을 연다

 

사실 그 다음부터는 카페24가 떠먹여주는거라 내가 뭘 할 이유가 없었는데...

순서대로 적어본다.

 

포스트맨 프로그램을 열고 문서 중간에 Run in Postman을 누른다. 

 

 

 

 

그러면 Cafe24가 보여주는 API 컬렉션을 추가할 수 있다.

문서에 나온 것처럼 왼쪽에 Collection 탭에 Cafe24 API라고 떠 있는 것을 볼 수 있다.

 

 

 

5️⃣ 환경설정하기

 

카페24 API 환경설정 파일을 다운로드 받는다.

POSTMAN포스트맨 왼쪽 메뉴에 보면 Environments 라는 아이콘이 있다.

이걸 클릭해서 카페24 문서가 제공하는대로 ClientID, Secret key 등을 채워넣는다.

만약 기록을 깜빡했으면 문서 페이지 상단에 '로그인' 눌러서 로그인 한다음에 '어드민' 들어가서 앱 기본정보에서 확인하면된다.

 

 

 

6️⃣ 토큰 발급받기

 

이 내용도 문서의 도움을 받아야 하는데

나는 기존에 토큰 발급 앱을 미리 만들어두셔서 해당 앱에서 토큰을 발급받고 서버의 로그로 확인한다.

문서에 나온 그대로 진행하면 된다.

 

 

 

 

이제 API를 확인할 준비는 끝났다.

 

내가 보고싶은 API를 왼쪽 Collections에서 선택하거나

상단에 + 버튼을 눌러 API url을 입력해도 된다.

 

내가 볼 API는 salesvolume API인데 해당 주소가 이미 코드화 되어 있어서 붙여넣기 했다.

값을 가져오는 것이기 때문에 왼쪽 셀렉트 메뉴는 GET 으로 설정하고 key 값을 입력한다.

그럼 상단에 ?와 &로 연결된다.

 

 

 

 

 

 

그리고 해야할 일은 Authorization을 확인하는 것인데

POSTMAN의 Authorize Access Token 로 받은 토큰을 입력하면 된다.

 

 

 

TOKEN 부분에 아까 받은 토큰을 입력하면 된다.

 

 

 

토큰은 2시간 짜리라서 2시간마다 새로 발급받아야 한다.

 

토큰을 입력하고 왼편의 Send를 누르면 아래 Body에 JSON 값으로 API를 받아볼 수 있다.

카페24 정책에 따라 읽고 쓰기가 가능한 API, 읽기만 가능한 API가 있기 때문에 GET과 POST 요청을 잘 사용해서 값을 확인하면 된다.

 

 

볼 줄은 아는데 쓸 줄을 모르니 빨리 쓰는 법을 배워야겠다.