# Toss Open API 승인 준비 체크리스트

> 이 문서는 실제 신청 직전 다시 공식 문서를 확인하는 운영용 체크리스트입니다.

## 서비스 설명

- 서비스명: PickBrief
- 유형: 상품 카탈로그/가격비교몰이 아닌 콘텐츠형 상품 큐레이션 미디어
- 운영 방식: 사용 상황과 목적을 먼저 정한 뒤, 하나의 콘텐츠 안에서 소수 상품만 선별 소개
- 상품 데이터 사용: 승인 전에는 실제 Toss 상품 API 데이터를 저장·노출하지 않음
- 승인 후: 허용 범위 내에서 상품 정보와 쉐어링크를 API Gateway를 통해 받아 콘텐츠에 삽입

## 신청 전 준비

- [ ] 공개 접속 가능한 서비스 URL 준비
- [ ] 홈 화면과 샘플 콘텐츠가 정상 표시되는지 확인
- [ ] 실제 쇼핑몰/가격비교 페이지처럼 보이는 대량 상품 목록이 없는지 확인
- [ ] 경제적 이해관계 고지 위치 확인
- [ ] 이미지 사용 방식 설명 준비
- [ ] API 데이터 저장/캐시 범위 설명 준비
- [ ] API 호출 서버의 고정 출발지 IP 확보 계획 준비
- [ ] Access Key / Secret Key를 저장소에 절대 커밋하지 않기

## 이미지 사용 계획

1. 사용이 허용된 공식 상품 이미지를 최우선 사용
2. 실제 상품 이미지가 부족할 경우 상품 자체를 복제한 AI 이미지를 만들지 않음
3. 콘텐츠의 상황·주제를 설명하는 AI 연출 이미지만 별도로 생성
4. AI 생성 이미지는 사용자에게 AI 생성 이미지임을 명확히 표시
5. 이미지 저장·크롭·합성·재가공이 필요한 경우 사전에 허용 범위를 확인

## 승인 후 기술 연결 순서

1. 고정 IP API Gateway 준비
2. Toss Access Key / Secret Key를 서버 Secret에 저장
3. health/auth 테스트
4. 소량의 상품 조회 테스트
5. 쉐어링크 1건 발급 테스트
6. 캐시/중복 호출 방지 로직 연결
7. 콘텐츠 생성 파이프라인 연결
8. 링크 상태·품절·상품 변경 검증 로직 연결
9. 클릭/판매/정산 데이터 수집 연결
10. 성과 데이터를 다음 콘텐츠 선정에 반영

## 금지 원칙

- API 키를 HTML/JavaScript/GitHub에 노출하지 않음
- 승인 전 실제 API 데이터를 크롤링하거나 저장하지 않음
- 실제 상품처럼 오인될 수 있는 AI 합성 상품 이미지를 공식 이미지처럼 사용하지 않음
- 상품을 대량 나열하는 독립 쇼핑몰 또는 타 플랫폼 가격 비교 형태로 확장하지 않음
- 제휴 관계를 숨기지 않음