Cafe24 API 인증받고 API 호출까지

Cafe24 restAPI docs 참고하기

Cafe24를 활용해야 할 상황이 왔다. 정보가 아무것도 없기에 Cafe24 API를 익히는 것이 우선이라고 판단하여 천천히 API 호출 테스트를 시도해보려고 한다.

문서를 살펴보면, 대부분 api를 호출하는데 "Authorization"이라는 헤더정보가 필수적이다.

앱 생성 부터 Authorization인증, API 호출까지 진행해보자.

👉🏻앱 생성

1. https://www.cafe24.com/ 대표운영자 회원가입
2. https://developers.cafe24.com/ 로그인
3. 앱 관리 - 앱 등록

카페24 API 앱 관리 - 앱 등록

4. 정보 입력
App URL과 code를 확인할 Redirect URI를 넣어주고, 확인할 API의 권한을 선택해준다.

카페24 API 정보 입력

5. 하단에 인증정보탭에 있는 Client ID와 Client Secret key는 따로 적어주세요.

카페24 API  Client ID와 Client Secret key

6. 테스트 실행
앱을 실행할 쇼핑몰 ID를 입력하고, 실행 버튼 누르고 테스트 페이지를 확인한다.

카페24 API 테스트 실행

기본 템플릿을 가진 화면이 나오며 잘 출력되는 것을 볼 수 있습니다.

👉🏻인증부터 API호출까지 해보자.

카페24는 인증을 받는 과정을 웹표준인 OAuth 2.0 기반으로 하고 있습니다.
전체적은 그림은 다음과 같습니다.

카페24 API 인증 토큰 받은 절차 그림

👉🏻 access_token 발급(유효시간 1분)[참고링크]

https://{mall_id}.cafe24api.com/api/v2/oauth/authorize?response_type=code&client_id={client_id}&state={encode_csrf_token}
&redirect_uri={encode_redirect_uri}&scope={scope}

동의화면에서 동의 눌러주면 바뀐 URL에서 code 값을 확인 할 수 있습니다!

카페24 API 인증 코드 발급

이 코드는 1분간만 유효하니, 시간이 지나면 다시 발급 받아야합니다.

👉🏻 postman을 통해 token를 발급받아보자

Authorization은 client ID : Client Secret Key를 base64로 인코딩한 값입니다.

// base64로 인코딩 하는 방법
// 예시 - window.btoa('client ID:Client Secret Key')

window.btoa("FFNNaawwtFCyZdRDGuezQeT:QQsSNLddDUTi1DtZxPdwW3H")
//👉🏻결과: RkZOTmFhd3d0RkN5WmRSREd1ZXpRZVQ6UVFzU05MZGREVVRpMUR0WnhQZHdXM0g=

그럼 base64로 인코딩된 문자열이 리턴됩니다. 이게 Authorization 값입니다.

Authorization : Basic RkZOTmFhd3d0RkN5WmR....

그리고 반드시 앞에 Basic이라는 문자를같이 써줘야만 합니다.!!

Headers에 Content-Type와 Authorization를 넣고 
body에 grant_type, redirect_uri, 아까 발급받은 code를 넣어줍니다.

카페24 API Headers 값들

카페24 API body 값들

👉🏻access_token 발급 완료

카페24 API access_token 발급

access_token은 2시간이 지나면 만료가 되므로 그땐 refresh_token으로 아래와 같이 또 다시 새로
access_token을 발급 받아야 합니다.

카페24 API refresh_token 요청할때

👉🏻카테고리 조회 API

결과가 잘 출력 되는 것을 볼 수 있다!![참고링크]

카페24 API 카테고리 조회

참고링크에 들어가서 비교하면 해당 key가 뭔지 알수 있습니다.
API 문서도 깔끔하게 정리 잘되어 있네요ㅎㅎ👍🔥🥹🎉