시작하기
- 1
API 키 발급
마켓셀러 로그인 → 내 API 키에서 발급(회원사·셀러). 키는 SHA-256 해시로 보관됩니다.
- 2
인증 헤더 추가
모든 요청에 X-API-Key 헤더로 발급받은 키를 담습니다.
- 3
호출·연동
상품·주문·물류 엔드포인트를 호출해 여러분의 시스템과 연동합니다.
서버 환경 (테스트 · 실서버)
연동을 붙이기 전 테스트 서버에서 충분히 검증한 뒤 실서버로 전환하세요. Base URL만 바꾸면 됩니다.
테스트 (Sandbox)
https://api.dev.mktseller.net
연동 개발·검증용. 실제 주문/정산에 영향 없음. 먼저 여기로 붙이세요.
실서버 (Production)
https://api.mktseller.net
실 서비스. 테스트 검증 완료 후 Base URL만 이걸로 교체.
인증
발급받은 API 키를 X-API-Key 헤더에 담아 요청합니다. 키는 비공개로 보관하세요.
🧪 테스트 서버
curl https://api.dev.mktseller.net/api/v1/products \
-H "X-API-Key: YOUR_TEST_API_KEY"🚀 실서버
curl https://api.mktseller.net/api/v1/products \
-H "X-API-Key: YOUR_LIVE_API_KEY"※ 테스트·실서버 키는 별도입니다. 키 발급 화면·엔드포인트는 정식 오픈 시 확정 안내됩니다.
API
상품 (Products)
상품·옵션·가격·재고 조회 및 등록
- GET
/api/v1/products·상품 목록 조회베타 - GET
/api/v1/products/{id}·상품 상세(옵션 포함)베타 - POST
/api/v1/products/import·상품 일괄 등록(엑셀/JSON)베타
주문 (Orders)
주문 수집·상태·송장
- GET
/api/v1/orders·주문 목록 조회준비중 - POST
/api/v1/orders/{id}/tracking·송장 등록준비중
물류·배대지 (Logistics)
해외 물류·통관 상태
- GET
/api/v1/logistics/orders·해외 주문 물류 현황준비중 - GET
/api/v1/customs/{hbl}·통관 진행 조회준비중
응답은 JSON. 옵션은 상품당 최대 100개(오픈마켓 보수 한도). 요청 제한(rate limit)·에러 코드는 정식 문서에서 안내됩니다.
요금
분양몰 내 사용 — 무료
마켓셀러 회원사·셀러가 자사 운영에 쓰는 연동은 무료입니다.
외부 호출 — 사용량 기반
외부 시스템에서 데이터를 호출하는 경우 사용량 기반 과금(정식 오픈 시 요금표 공개).
문의·지원
연동 문의는 마켓셀러 고객센터로. 정식 오픈 시 개발자 전용 채널을 안내합니다.
마켓셀러 홈으로