API 상품 — 처음부터 판매까지

아래 화면 예시는 실제 새몰 화면과 동일한 구성으로 재현한 것입니다. 내 계정에서는 상품 등록과 상품 수정 페이지의 연동 정보 카드에서 같은 화면을 만나게 됩니다.

전달 방식은 여러 개를 고를 수 있습니다. 이 가이드는 API 상품 하나를 기준으로 설명하지만, 다른 방식과 함께 체크해도 됩니다. 방식마다 설정과 발급이 따로 적용됩니다. 세 축(상품 종류·가격 방식·전달 방식)이 어떻게 맞물리는지는 판매 가이드에 정리해 두었습니다.
가격을 매기려면 사업자 인증이 필요합니다. 개인사업자나 법인으로 정산 정보를 등록하고 인증을 마쳐야 유료 요금제를 설정할 수 있습니다. 비사업자는 0원(무료) 상품만 등록됩니다. 인증과 상관없이 연동 자체는 지금 그대로 따라 할 수 있습니다.

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()