시작하기

빠른 시작

파트너로 가입하고 API 키를 만든 뒤 첫 eSIM 검색 요청을 보내 보세요.

이 페이지 내용

API 키 받기
첫 요청 보내기
응답 읽기

API 키 받기#

1이심모아 계정으로 로그인하고 대시보드에서 파트너로 가입해요.
2대시보드의 API 키 섹션에서 키를 만들어요. 키는 한 번만 보이니 바로 저장하세요.

첫 요청 보내기#

아래처럼 호출하면 일본 7일 eSIM을 가격순으로 받아요.

curl "https://api.esimoa.com/v1/esims?country=JP&days=7&sort=price&limit=3&lang=en" \
  -H "X-API-Key: esk_live_your_key_here"

const res = await fetch(
  'https://api.esimoa.com/v1/esims?country=JP&days=7&sort=price&limit=3&lang=en',
  { headers: { 'X-API-Key': process.env.ESIMOA_API_KEY } },
);
if (!res.ok) throw new Error(`esimoa API ${res.status}`);

const { items, total } = await res.json();
for (const esim of items) {
  console.log(esim.title, esim.priceKrw, esim.url);
}

import os
import requests

res = requests.get(
    "https://api.esimoa.com/v1/esims",
    params={"country": "JP", "days": 7, "sort": "price", "limit": 3, "lang": "en"},
    headers={"X-API-Key": os.environ["ESIMOA_API_KEY"]},
    timeout=10,
)
res.raise_for_status()

for esim in res.json()["items"]:
    print(esim["title"], esim["priceKrw"], esim["url"])

응답 읽기#

기본 주소는 https://api.esimoa.com 이에요. 모든 응답은 JSON이고 금액은 원화(KRW) 정수예요.

각 상품의 url 에는 내 파트너 코드가 붙어 있어요. 이 링크를 그대로 노출해야 그 링크로 들어온 구매에 커미션이 적립돼요.

eSIM 검색모든 파라미터와 응답 필드 추적 링크와 커미션커미션이 적립되는 규칙