공개 API (/v1)

eSIM 상세

GET /v1/esims/:id — 검색 결과의 id로 상품 1개의 상세와 구매 링크를 받아요.

이 페이지 내용

요청
파라미터
응답
오류

요청#

GET/v1/esims/:id

curl "https://api.esimoa.com/v1/esims/partner_9VKPYQ3JRYVK5797?lang=en" \
  -H "X-API-Key: esk_live_your_key_here"

const id = 'partner_9VKPYQ3JRYVK5797';
const res = await fetch(`https://api.esimoa.com/v1/esims/${encodeURIComponent(id)}?lang=en`, {
  headers: { 'X-API-Key': process.env.ESIMOA_API_KEY },
});
if (res.status === 404) {
  // the plan is no longer on sale — drop it from your listing
}
const { item } = await res.json();

res = requests.get(
    f"https://api.esimoa.com/v1/esims/{esim_id}",
    params={"lang": "en"},
    headers={"X-API-Key": os.environ["ESIMOA_API_KEY"]},
    timeout=10,
)
if res.status_code == 404:
    ...  # the plan is no longer on sale
item = res.json()["item"]

파라미터#

파라미터	타입	설명
`id`필수	string	경로 — 검색 결과의 id
`lang`	string	응답 언어 ko \| en \| ja \| zh-CN \| zh-TW (기본 en)

응답#

item 은 검색 결과의 Esim 객체와 같은 모양이에요.

200 OKjson

{
  "success": true,
  "item": { "id": "partner_9VKPYQ3JRYVK5797", "title": "Japan · 100 MB · 7 days", "...": "..." }
}

오류#

없거나 판매가 끝난 상품 ID는 404 eSIM not found 예요. 저장해 둔 상품이라면 목록에서 빼세요.

공개 API (/v1)

eSIM 상세

GET /v1/esims/:id — 검색 결과의 id로 상품 1개의 상세와 구매 링크를 받아요.

이 페이지 내용

요청
파라미터
응답
오류

요청#

GET/v1/esims/:id

curl "https://api.esimoa.com/v1/esims/partner_9VKPYQ3JRYVK5797?lang=en" \
  -H "X-API-Key: esk_live_your_key_here"

const id = 'partner_9VKPYQ3JRYVK5797';
const res = await fetch(`https://api.esimoa.com/v1/esims/${encodeURIComponent(id)}?lang=en`, {
  headers: { 'X-API-Key': process.env.ESIMOA_API_KEY },
});
if (res.status === 404) {
  // the plan is no longer on sale — drop it from your listing
}
const { item } = await res.json();

res = requests.get(
    f"https://api.esimoa.com/v1/esims/{esim_id}",
    params={"lang": "en"},
    headers={"X-API-Key": os.environ["ESIMOA_API_KEY"]},
    timeout=10,
)
if res.status_code == 404:
    ...  # the plan is no longer on sale
item = res.json()["item"]

파라미터#

파라미터	타입	설명
`id`필수	string	경로 — 검색 결과의 id
`lang`	string	응답 언어 ko \| en \| ja \| zh-CN \| zh-TW (기본 en)

응답#

item 은 검색 결과의 Esim 객체와 같은 모양이에요.

200 OKjson

{
  "success": true,
  "item": { "id": "partner_9VKPYQ3JRYVK5797", "title": "Japan · 100 MB · 7 days", "...": "..." }
}

오류#

없거나 판매가 끝난 상품 ID는 404 eSIM not found 예요. 저장해 둔 상품이라면 목록에서 빼세요.