시작하기
소개
이심모아 eSIM 상품을 내 사이트·앱·AI 어시스턴트에 연결하는 REST API와 MCP 서버 문서예요.
무엇을 만들 수 있나요#
- 상품 검색 API — 국가·기간·데이터량으로 이심모아 eSIM을 검색해 내 사이트·앱에 실시간 가격과 함께 보여주세요.
- 추적 링크 커미션 — API 응답의 구매 링크에는 내 파트너 코드가 붙어 있어요. 그 링크로 들어온 고객이 결제하면 커미션이 적립돼요.
- AI 연동 (MCP) — ChatGPT·Claude·Gemini에 이심모아 MCP 서버를 연결하면 AI가 eSIM을 검색·비교하고 구매 링크를 알려줘요.
- 파트너 API (B2B) — 계약된 B2B 판매처·제휴사가 서버에서 이심모아 상품 카탈로그를 받아 자체 판매 화면을 만들 수 있어요.
어떤 API를 써야 하나요#
이심모아에는 키가 서로 다른 두 가지 REST API가 있어요. 대부분의 사이트·블로그·AI 서비스는 공개 API로 충분해요.
| 공개 API (/v1) | 파트너 API (B2B) | |
|---|---|---|
| 대상 | 제휴 마케팅 파트너 — 이심모아 회원 누구나 | 계약된 B2B 판매처·제휴사 |
| 키 발급 | 개발자 센터 대시보드 | 파트너 포털 |
| 키 형식 | esk_live_<32> | esk_live_<10>_<40> |
| 기본 주소 | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| 수익 방식 | 응답의 추적 링크로 들어온 구매에 커미션 | 계약 조건에 따라 |
이렇게 동작해요#
- 1이심모아 계정으로 로그인하고 사이트 정보를 입력하면 파트너 코드가 바로 발급돼요.
- 2대시보드에서 API 키를 만들어요. 키는 만들 때 한 번만 보여요.
- 3API로 검색한 상품과 응답의 url(파트너 코드 포함)을 내 서비스에 보여줘요.
- 4고객이 그 링크로 결제하면 커미션이 적립되고 대시보드에서 확인할 수 있어요.