공개 API (/v1)

판매 국가

GET /v1/countries — eSIM을 판매하는 국가와 상품 수·최저가를 받아요.

이 페이지 내용

요청
쿼리 파라미터
응답
Country 객체

요청#

GET/v1/countries

curl "https://api.esimoa.com/v1/countries?q=japan&lang=en" \
  -H "X-API-Key: esk_live_your_key_here"

const res = await fetch('https://api.esimoa.com/v1/countries?q=japan&lang=en', {
  headers: { 'X-API-Key': process.env.ESIMOA_API_KEY },
});
const { items } = await res.json();

res = requests.get(
    "https://api.esimoa.com/v1/countries",
    params={"q": "japan", "lang": "en"},
    headers={"X-API-Key": os.environ["ESIMOA_API_KEY"]},
    timeout=10,
)
countries = res.json()["items"]

쿼리 파라미터#

파라미터	타입	설명
`q`	string	국가 이름·코드 검색어 (선택)
`lang`	string	응답 언어 ko \| en \| ja \| zh-CN \| zh-TW (기본 en)

q 는 5개 언어의 국가 이름 어느 것으로도 찾을 수 있어요 (예: japan, 일본, 日本).

응답#

200 OKjson

{
  "success": true,
  "items": [
    {
      "countryCode": "JP",
      "name": "Japan",
      "planCount": 128,
      "lowestPriceKrw": 1000,
      "url": "https://www.esimoa.com/en/plans/jp?ref=p_yourcode"
    }
  ]
}

Country 객체#

필드	타입	설명
`countryCode`	string	ISO 3166-1 alpha-2 국가 코드
`name`	string	국가 이름 (lang 기준)
`planCount`	integer	판매 중인 상품 수
`lowestPriceKrw`	integer \| null	최저가 (원화)
`url`	string	국가별 요금제 페이지 — 내 파트너 코드(?ref=) 포함

공개 API (/v1)

판매 국가

GET /v1/countries — eSIM을 판매하는 국가와 상품 수·최저가를 받아요.

이 페이지 내용

요청
쿼리 파라미터
응답
Country 객체

요청#

GET/v1/countries

curl "https://api.esimoa.com/v1/countries?q=japan&lang=en" \
  -H "X-API-Key: esk_live_your_key_here"

const res = await fetch('https://api.esimoa.com/v1/countries?q=japan&lang=en', {
  headers: { 'X-API-Key': process.env.ESIMOA_API_KEY },
});
const { items } = await res.json();

res = requests.get(
    "https://api.esimoa.com/v1/countries",
    params={"q": "japan", "lang": "en"},
    headers={"X-API-Key": os.environ["ESIMOA_API_KEY"]},
    timeout=10,
)
countries = res.json()["items"]

쿼리 파라미터#

파라미터	타입	설명
`q`	string	국가 이름·코드 검색어 (선택)
`lang`	string	응답 언어 ko \| en \| ja \| zh-CN \| zh-TW (기본 en)

q 는 5개 언어의 국가 이름 어느 것으로도 찾을 수 있어요 (예: japan, 일본, 日本).

응답#

200 OKjson

{
  "success": true,
  "items": [
    {
      "countryCode": "JP",
      "name": "Japan",
      "planCount": 128,
      "lowestPriceKrw": 1000,
      "url": "https://www.esimoa.com/en/plans/jp?ref=p_yourcode"
    }
  ]
}

Country 객체#

필드	타입	설명
`countryCode`	string	ISO 3166-1 alpha-2 국가 코드
`name`	string	국가 이름 (lang 기준)
`planCount`	integer	판매 중인 상품 수
`lowestPriceKrw`	integer \| null	최저가 (원화)
`url`	string	국가별 요금제 페이지 — 내 파트너 코드(?ref=) 포함