따라하기 가이드전 플랜 사용 가능구매 후 권한·전달 처리
API 상품 — 처음부터 판매까지
API를 상품으로 판매하는 방식입니다. 결제가 끝나면 새몰이 API 키를 발급하고, 판매자 서버는 요청마다 키와 호출 한도를 확인합니다.
시작 전에 준비하세요
- 판매할 상품과 제공할 내용을 정합니다.
- 상품 등록에서 전달 방식을 선택합니다. 여러 방식을 함께 설정할 수 있습니다.
- 이 가이드에 따라 설정한 뒤 다른 계정으로 전달 결과를 확인합니다.
화면 예시·전달 방식·판매 조건 자세히 보기
아래 화면 예시는 실제 새몰 화면과 동일한 구성으로 재현한 것입니다. 내 계정에서는 상품 등록과 상품 수정 페이지의 연동 정보 카드에서 같은 화면을 만나게 됩니다.
한눈에 보기
1구매자새몰결제 → API Key(mfk_…) 자동 발급
2구매자판매자내 API에 X-API-Key 헤더로 요청
3판매자새몰요청마다(캐시 권장) 권한 확인 + Rate Limit 적용
4새몰판매자환불·회수 시 api_key.revoked 웹훅
따라하기
1
상품 등록 — OpenAPI 명세와 Rate Limit
saemol.com/products/new
전달 방식 *
API 상품결제 즉시 API Key를 발급합니다.
사용량 측정사용량을 집계하고 한도를 적용합니다.
OpenAPI 명세 URL (선택)
https://api.translate.io/openapi.json
구매자에게 상품 상세와 전달 정보에 안내됩니다
Rate Limit (분당 요청 수) (선택)
60
권한 확인 API 응답에 포함되어 판매자 서버에서 적용합니다
2
결제 → API Key 발급
saemol.com/orders/… (구매자 화면)
전달 정보
API Key
mfk_e04b…77afAPI Key가 발급되었습니다. API 명세: https://api.translate.io/openapi.json (Rate Limit: 분당 60회)
3
API 게이트웨이에서 키 검증
middleware.ts — 요청마다 확인 (캐시 권장)
const ent = await saemol.verifyEntitlement({ apiKey: req.headers['x-api-key'] })
if (!ent.valid) return res.status(401).json({ error: 'invalid_api_key' })
applyRateLimit(req, ent.rate_limit_per_min) // 상품 설정값이 응답에 포함
next()검증 결과는 키별로 짧게 캐시하고 만료 시각을 넘기지 마세요. 회수 웹훅을 받으면 해당 키의 캐시를 비웁니다. 웹훅은 지연·재발송될 수 있으므로 검증 결과와 함께 확인하세요.
4
키 수명주기 운영
환불 시 자동 회수되고, 유출 의심 키는 라이선스 관리에서 재발급(구키 무효 + 새키 발급)할 수 있습니다. api_key.issued/api_key.revoked 웹훅(Business부터)으로 내 게이트웨이 캐시를 즉시 비울 수 있습니다.
출시 전 체크리스트
- OpenAPI 명세 URL이 공개 접근 가능하다
- 401 응답에 구매 안내(상품 페이지 링크)를 담았다
- 테스트 키로 게이트웨이 통과 → 회수 후 401까지 확인했다