개요
파트너 API (B2B)
파트너 포털 계정을 가진 B2B 판매처·제휴사가 서버에서 이심모아 상품 카탈로그를 조회하는 API예요.
누구를 위한 API인가요#
파트너 API는 이심모아와 계약하고 파트너 포털 계정을 받은 B2B 판매처·여행사·기업 제휴사를 위한 API예요. 이심모아가 판매하는 상품 카탈로그를 서버에서 그대로 받아 자체 판매·상담 화면을 만들 수 있어요.
가격(priceKRW)은 이심모아 소비자가(원화)이고, 공급사·원가 정보는 응답에 들어 있지 않아요.
팁
블로그·비교 사이트·AI 서비스를 운영한다면 누구나 가입해 커미션을 받을 수 있는 공개 API를 쓰세요.
이용 신청#
- 1제휴 문의로 연락 주세요. 계정은 이심모아가 검토 후 만들어 드려요.
- 2계정 담당자(OWNER)에게 초대 메일이 가요. 링크는 72시간 동안 한 번만 쓸 수 있고, 비밀번호를 정하면 바로 로그인돼요.
- 3파트너 포털의 API 키 메뉴에서 키를 발급해요.
기본 주소#
url
https://api.esimoa.com/b2b/v1주의
서버 간 연동 전용이에요. 외부 사이트의 브라우저 호출은 CORS로 허용하지 않습니다. 반드시 백엔드에서 호출하고, 키를 프런트엔드·앱 코드에 넣지 마세요.
엔드포인트#
| 엔드포인트 | 설명 |
|---|---|
| GET /b2b/v1/products | 상품 검색 |
| GET /b2b/v1/products/:id | 상품 1개 |
| GET /b2b/v1/countries | 판매 국가 목록 |
모든 엔드포인트는 키에 catalog:read 권한이 있어야 해요 (기본으로 들어 있어요).
응답 형식#
성공하면 data 에 결과가 담기고, 목록은 total·page·limit 이 함께 와요. 실패하면 code 가 들어 있어요 — 문구(message)는 영어이고 바뀔 수 있으니 code 로 분기하세요.
json
// Success
{ "success": true, "data": ..., "total": 128, "page": 1, "limit": 20 }
// Error
{ "statusCode": 401, "code": "INVALID_API_KEY", "message": "The API key is invalid." }공개 API와 비교#
| 파트너 API (B2B) | 공개 API (/v1) | |
|---|---|---|
| 키 발급 | 파트너 포털 | 개발자 센터 대시보드 |
| 페이지 나누기 | page (1~) · limit ≤ 50 | offset · limit ≤ 50 |
| 가격 필드 | priceKRW | priceKrw |
| 구매 링크 | 없음 — 판매는 계약에 따라 | url (파트너 코드 포함) |
| 공급사 정보 | 포함하지 않음 | provider |
| 요청 한도 | 키당 분당 300회 (계정별 조정) | 파트너당 분당 600회 |