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

تفاصيل المنتج

GET /b2b/v1/products/:id — get one product by the id from search results.

On this page

Request
الاستجابة
Errors

Request#

GET/b2b/v1/products/:id

curl "https://api.esimoa.com/b2b/v1/products/partner_9VKPYQ3JRYVK5797" \
  -H "X-API-Key: $ESIMOA_PARTNER_KEY"

const res = await fetch(`https://api.esimoa.com/b2b/v1/products/${encodeURIComponent(id)}`, {
  headers: { 'X-API-Key': process.env.ESIMOA_PARTNER_KEY },
});
if (res.status === 404) {
  // PRODUCT_NOT_FOUND — no longer on sale, remove it from your catalog
}
const { data: product } = await res.json();

res = requests.get(
    f"https://api.esimoa.com/b2b/v1/products/{product_id}",
    headers={"X-API-Key": os.environ["ESIMOA_PARTNER_KEY"]},
    timeout=10,
)
if res.status_code == 404:
    ...  # PRODUCT_NOT_FOUND — no longer on sale
product = res.json()["data"]

id هو المعرّف الوارد في نتائج البحث عن المنتجات (يبدأ بـ partner_).

الاستجابة#

data هو كائن PartnerProduct واحد.

200 OKjson

{
  "success": true,
  "data": { "id": "partner_9VKPYQ3JRYVK5797", "name": "Japan Unlimited 5일", "...": "..." }
}

Errors#

يؤدي المعرّف غير الصالح أو غير المعروف أو المنتج الذي لم تعد esimoa تبيعه مباشرة إلى إرجاع 404 PRODUCT_NOT_FOUND. أزله من الكتالوج المحفوظ لديك.

404 Not Foundjson

{ "statusCode": 404, "code": "PRODUCT_NOT_FOUND", "message": "Product not found." }