Taobao Global API KEY 발급방법

open.taobao.global App 등록부터 더망고 솔루션 환경설정 적용, OAuth 인증까지 전 과정을 안내합니다. distributor.taobao.global 계정 생성 포함.

Taobao Global API 는 더망고 솔루션에서 타오바오(중국 1688 도매) 상품을 수집/주문 하기 위한 공식 API 입니다.

API 사용에는 두 개의 별도 계정이 필요합니다:

· Taobao Global Open Platform 계정 (open.taobao.global) — App 등록 / AppKey·AppSecret 발급

· TaoWorld 타오바오 Global 플렛폼 계정 (distributor.taobao.global) — 실제 OAuth 인증을 받기 위한 운영용 계정

두 계정 모두 무료 가입 가능합니다.

1. TaoWorld 타오바오 Global 플렛폼 계정 생성 (distributor.taobao.global)

OAuth 인증 단계에서 사용되는 운영용 계정입니다. 먼저 이 계정부터 생성 합니다.

· 접속: https://distributor.taobao.global/

우측 상단 한국인(언어 선택) 을 클릭하여 한국어로 전환하면 편합니다.

로그인 페이지 하단의 "아직 계정이 없습니까? 즉시 등록" 또는 직접 회원가입 페이지로 이동.

TaoWorld 로그인 페이지

2. 회원가입 정보 입력

회원가입 페이지 입력 항목:

· 이메일 주소 — 본인 이메일

· 이메일 확인 코드 — [코드 전송] 클릭 후 메일로 받은 6자리 코드 입력

· 비밀번호 / 비밀번호 확인 — 영문 + 숫자 + 특수문자 조합

· 계정 이름 — 표시용 이름 (자유)

· 약관 동의 체크박스 체크

마지막으로 [회원 가입] 클릭.

TaoWorld 회원가입 페이지

※ 가입 후 단계 2 (입력 정보) 와 단계 3 (정보 검토) 추가 절차가 있을 수 있습니다. 화면 안내대로 진행하세요.

3. Taobao Global Open Platform 계정 생성 (open.taobao.global)

App 을 등록하기 위한 개발자 계정입니다.

· 접속: https://open.taobao.global/

· 직접 가입: https://iopaccount.taobao.global/register

회원가입 입력 항목:

· Email Address — 본인 이메일

· Slider to get SMS Code — 슬라이더를 끝까지 밀어서 인증코드 받기

· Password — 8자 이상, 영문+숫자+특수문자 필수 (단 < > 공백은 불가)

· Full Name — 본인 영문 이름 (First Last)

· 약관 동의 체크박스 → [SIGN UP] 클릭

open.taobao.global 회원가입

4. Taobao Global Open Platform 로그인

가입 후 open.taobao.global 우측 상단 [Login] 클릭.

등록한 이메일과 비밀번호로 로그인합니다.

open.taobao.global 로그인

5. App Console 진입

로그인 후 우측 상단 본인 이메일을 클릭하면 드롭다운 메뉴가 나타납니다.

· App Console 클릭

App 목록 화면이 표시됩니다 (처음 가입한 경우 빈 목록).

App Console 목록

6. App 카테고리 선택

우측 상단 [Create] 버튼 클릭.

App 카테고리 3개 중 TaoWorld跨境供货平台 (TaoWorld 국경간 공급 플랫폼) 만 Active 상태입니다. 이 카테고리의 [Create App] 버튼 클릭.

App 카테고리 선택

※ 나머지 두 카테고리(海外联盟 / 海外供给合作商) 는 Inactive 라서 [Apply] 만 가능하고 즉시 사용 불가합니다. 반드시 TaoWorld 跨境供货平台 선택.

7. App 정보 입력

다음 4개 항목을 모두 입력합니다. 모두 필수 입니다.

① App Name (128자 이내)

· 예: THEMANGO 또는 themango_solution

· 영문 권장. 식별용이라 자유로 정해도 무관.

② Callback URL (200자 이내) — 가장 중요

OAuth 인증 후 토큰 교환에 사용되는 redirect URI 입니다. 본인의 더망고 솔루션 도메인 으로 정확히 입력해야 합니다.

본인 서버 기준 입력값 (그대로 복사):

https://tmgXXXX.(my)cafe24.com/api/taobao_global/getToken

https:// 필수 / 끝에 슬래시 X / 호스트명 정확히 일치해야 함. 한 글자라도 다르면 OAuth 토큰 교환 시 invalid_redirect_uri 에러 발생.

③ App Description (1000자 이내)

· 예: 더망고 솔루션 연동

④ App Logo — png/jpg, 100x100 px 권장

· 자유 이미지 업로드. 권장 로고: themango 로고 다운로드

모두 입력 후 [Submit] 클릭.

App 정보 입력 완료 화면

8. App 생성 완료

Congratulations! Your App Created successfully. 화면이 표시되면 정상 등록된 것입니다.

[Overview] 버튼을 클릭하여 AppKey/AppSecret 발급 화면으로 이동합니다.

App 생성 완료

9. AppKey / AppSecret 확인 (가장 중요)

App Overview 페이지에 다음 정보가 표시됩니다:

· AppKey — 6자리 숫자 (예: 504504)

· App Secret[View] 클릭해야 보임. 32자 영숫자 (예: I1OiPMKk...sgOzXdRU)

· App StatusTest (초기 상태. 정식 운영 시 Apply Online 으로 승인 신청)

App Overview - AppKey 확인

※ App Secret 은 절대 노출되면 안 되는 비밀키 입니다. 화면 캡처/이메일/메신저 등으로 공유 금지. 유출 시 즉시 [Reset] 으로 재발급하세요.

10. 더망고 솔루션에 적용

발급받은 AppKey / AppSecret 을 더망고 솔루션 관리자 페이지에 입력합니다.

· 더망고 솔루션 관리자 페이지 로그인

· 환경설정 → API 연동키 설정 → Taobao Global API

· App Key 입력란에 발급받은 6자리 숫자 (504504) 붙여넣기

· App Secret 입력란에 발급받은 32자 키 붙여넣기

· 상단 [설정저장] 클릭

더망고 솔루션 환경설정

11. OAuth 인증 수행

AppKey / AppSecret 만 입력한 상태에서는 아직 API 호출이 불가능합니다. OAuth 인증 을 한 번 수행해야 access_token 이 발급되어 정상 동작합니다.

· Taobao Global API 행의 [인증하기] 버튼 클릭

· 새 창에서 TaoWorld 타오바오 Global 플렛폼 로그인 화면이 열림

· 1단계에서 생성한 distributor.taobao.global 계정 으로 로그인

· 권한 동의 → 자동으로 더망고 솔루션으로 돌아옴

· 화면에 "API 연동 상태: 연동됨" 표시되면 완료

※ 인증 시 사용할 계정은 open.taobao.global 계정이 아니라 distributor.taobao.global 계정 (1단계에서 만든 것) 입니다. 두 계정을 혼동하기 쉬우니 주의하세요.

참고 — 공식 문서 / 링크

· Taobao Global Open Platform — App 등록

· TaoWorld 타오바오 Global 플렛폼 — OAuth 인증용 계정

· Taobao Global Open Platform 문서

· 공지사항

tmgXXXX.(my)cafe24.com 은 본인의 더망고 관리자페이지 [환경설정] - [서비스정보] - [서비스 URL] 참고