API تفاصيل المنتج
POST /v1/products/detail — يجلب تفاصيل المنتج الكاملة لتكامل checkout (مصفوفة SKU، الأسعار، المخزون).
ذات صلة: نماذج استجابة المنتجات · تعيين الشراء
جسم الطلب
| الحقل | مطلوب | الوصف |
|---|---|---|
channel | نعم | 1688 | taobao | weidian |
product_id | واحد من | 1688 offerId؛ في Taobao يفضل mi_id على item_id القديم |
id | واحد من | نفس id البحث. Taobao = mi_id؛ 1688 = offerId |
url | واحد من | رابط صفحة المنتج |
mi_id | Taobao | معرف منتج TaoWorld (موصى به للطلبات) |
tao_password | Taobao | Taobao share口令 — الصق نص المشاركة الكامل أو سلسلة 口令 |
language | لا | الافتراضي en |
response_format | لا | standard (الافتراضي) أو upstream |
يتغيّر
id/mi_idفي Taobao دوريا. لا تخزّنه طويلا. المعرفات القديمة تفشل في detail وsimilar والطلبات. أعد الجلب قبل الدفع.
أمثلة
Taobao口令:
POST /v1/products/detail
{
"channel": "taobao",
"tao_password": "￥abc123￥ 复制这条信息...",
"language": "en"
}1688 offer id:
POST /v1/products/detail
{
"channel": "1688",
"product_id": "554456348334",
"language": "en"
}الاستجابة
StandardProductDetail مغلفا بالشكل { "product": { ... }, "request_id": "req_..." } — راجع نماذج استجابة المنتجات.
اختيار المتغيرات
ابن واجهة checkout من product.variants[] — راجع نمط التكامل. عند مطابقة الخيارات فضّل prop_id + value_id (Taobao) أو prop_id (1688).
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days