واجهة API للشركاء (B2B)

البلدان

GET /b2b/v1/countries — list countries that have products on sale, with Korean or English names.

On this page

Request
Query parameters
الاستجابة

Request#

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"]

Query parameters#

المعامل	النوع	الوصف
`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 في بحث المنتجات.