파트너 API (B2B)

판매 국가

GET /b2b/v1/countries — 판매 상품이 있는 국가 목록을 한국어 또는 영어 이름으로 받아요.

이 페이지 내용

요청
쿼리 파라미터
응답

요청#

GET/b2b/v1/countries

curl "https://api.esimoa.com/b2b/v1/countries?lang=en" \
  -H "X-API-Key: $ESIMOA_PARTNER_KEY"

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

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

쿼리 파라미터#

파라미터	타입	설명
`lang`	'ko' \| 'en'	국가 이름 언어 (기본 ko)

응답#

200 OKjson

{
  "success": true,
  "data": [
    { "countryCode": "AU", "name": "Australia", "planCount": 64 },
    { "countryCode": "JP", "name": "Japan", "planCount": 128 }
  ]
}

필드	타입	설명
`countryCode`	string	ISO 3166-1 alpha-2 국가 코드
`name`	string	국가 이름 (lang 기준)
`planCount`	integer?	판매 중인 상품 수 — 모르면 생략

목록은 요청한 언어의 국가 이름순이고, 판매 상품이 없는 국가와 다국가 상품은 빠져요. 다국가 상품은 상품 검색에서 isMultiCountry=true 로 찾으세요.