Shopify 연동

본인의 Shopify 스토어에서 상품을 직접 가져와 진단을 만들 수 있습니다. API 키만 있으면 1분 안에 끝납니다.

준비

• Shopify Admin 접근 권한 (스토어 owner 또는 staff with apps_management 권한)
• 약 5분

1단계 — Custom App 만들기

1. Shopify Admin → Settings → Apps and sales channels → Develop apps
2. Create an app 클릭
3. 앱 이름 입력 (예: CurateAI)

2단계 — Admin API 권한 설정

1. 생성된 앱에서 Configuration 탭 → Admin API integration 섹션 → Configure
2. read_products 권한만 체크 → Save

CurateAI는 상품 읽기 권한만 요구합니다. 쓰기·삭제·고객정보·결제 권한은 절대 요청하지 않습니다.

3단계 — Install + 토큰 복사

1. 앱 페이지 상단 Install app 클릭
2. 설치 확인 화면 → 다시 Install
3. API credentials 탭에 Admin API access token이 표시됩니다.
4. 토큰은 shpat_로 시작 — 한 번만 표시되므로 반드시 복사하세요.

4단계 — CurateAI에서 연결

/dashboard/new Step 1에서 Shopify에서 직접 가져오기 카드를 클릭하세요.

| 입력 항목 | 예시 | |---|---| | 스토어 도메인 | mystore.myshopify.com | | Admin API access token | shpat_xxxx... (방금 복사한 값) |

연결하고 상품 가져오기 버튼을 누르면:

1. CurateAI 서버가 /admin/api/2025-01/shop.json으로 토큰 검증
2. 최대 50개 상품 가져와 위자드 items에 자동 주입
3. 토큰은 AES-256-GCM으로 암호화되어 저장 (평문 저장 안 됨)

보안

• 토큰은 응답에서 마스킹 (shpat_***1a2b 형식)
• 외부 API 호출 timeout 15초 + 1회 재시도
• ?platform=shopify로 /api/integrations DELETE → 연결 해제 가능

문제 해결

Invalid access token 422 오류

• 토큰 prefix shpat_ 확인
• Custom app이 Install 상태인지 확인 (Configuration만 저장하면 토큰 비활성)
• read_products 권한이 저장됐는지 확인

상품 0개 반환

• 스토어에 published 상품이 있는지 확인 (draft 상태는 제외됨)
• 스토어 도메인이 정확한지 (*.myshopify.com 형식, custom domain X)