API البحث عن المنتجات بالصورة
POST /v1/products/search-by-image — يعثر على منتجات مشابهة بالصورة على 1688 وTaobao.
مرر image_id من رفع صورة، أو أرسل image_base64 / image_url للرفع والبحث في استدعاء واحد.
جسم الطلب
| الحقل | مطلوب | الوصف |
|---|---|---|
channel | نعم | 1688 | taobao |
image_id | واحد من | من upload-image |
image_base64 / image_url | واحد من | رفع + بحث في خطوة واحدة |
image_address | 1688 | رابط صورة alicdn/1688 موجود |
region | لا | صندوق القص، مثل 266,799,48,581 |
keyword | لا | تحسين النتائج داخل نتائج الصورة |
page / page_size | لا | الترقيم |
language | لا | الافتراضي en |
مثال
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}الاستجابة
مثل البحث بالكلمات المفتاحية — StandardProductList، إضافة إلى pic_region_info اختياري (منطقة العنصر المكتشفة).
التدفق الموصى به {#image-search-flow}
الخيار A — خطوتان (إعادة استخدام image_id):
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...الخيار B — خطوة واحدة:
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }