パートナーAPI（B2B）
販売国
GET /b2b/v1/countries — 販売商品がある国の一覧を韓国語または英語の名前で取得します。
リクエスト#
GET
/b2b/v1/countriescurl "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 を指定してください。