?

在電商系統(tǒng)開(kāi)發(fā)或貨源查找工具中，按圖搜索商品是一項(xiàng)非常實(shí)用的功能。1688平臺(tái)作為國(guó)內(nèi)領(lǐng)先的B2B電商平臺(tái)，提供了官方的按圖搜索商品API接口。本文將詳細(xì)講解如何調(diào)用該接口。

一、 接口概述

該API允許開(kāi)發(fā)者通過(guò)上傳商品圖片，檢索1688平臺(tái)上與之相似的商品列表。其核心功能是圖像識(shí)別與商品匹配。

二、 準(zhǔn)備工作

獲取API權(quán)限

訪問(wèn)1688開(kāi)放平臺(tái)注冊(cè)開(kāi)發(fā)者賬號(hào)。

創(chuàng)建應(yīng)用，獲取 App Key 和 App Secret。

在應(yīng)用權(quán)限中申請(qǐng) 按圖搜索商品 接口權(quán)限。

圖片要求

圖片格式支持：JPG, JPEG, PNG。

圖片大?。航ㄗh小于1MB。

圖片尺寸：建議最小邊 ≥ 256像素，清晰無(wú)過(guò)多干擾元素。

三、 API調(diào)用詳解

接口地址

https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.image.search

請(qǐng)求方法 POST

請(qǐng)求參數(shù) 關(guān)鍵參數(shù)如下：

請(qǐng)求示例 (Python)

import requests
from requests_toolbelt.multipart.encoder import MultipartEncoder

# 替換為你的實(shí)際信息
app_key = 'your_app_key'
app_secret = 'your_app_secret'
access_token = 'your_access_token'  # 需要通過(guò)OAuth2流程獲取
image_path = '/path/to/your/product.jpg'

# 構(gòu)建請(qǐng)求URL
url = 'https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.image.search'

# 構(gòu)建Multipart/form-data請(qǐng)求體
multipart_data = MultipartEncoder(
    fields={
        'access_token': access_token,
        'image': ('image.jpg', open(image_path, 'rb'), 'image/jpeg'),  # 注意字段名和文件名
        'page': '1',
        'pageSize': '20',
        'similarDegree': '0.7'
    }
)

# 設(shè)置請(qǐng)求頭
headers = {
    'Content-Type': multipart_data.content_type
}

# 發(fā)送請(qǐng)求
response = requests.post(url, data=multipart_data, headers=headers)

# 處理響應(yīng)
if response.status_code == 200:
    result = response.json()
    # 解析返回的商品列表數(shù)據(jù)
    print(result)
else:
    print(f"請(qǐng)求失敗，狀態(tài)碼: {response.status_code}")

四、 響應(yīng)解析

成功調(diào)用后，接口返回JSON格式數(shù)據(jù)。主要結(jié)構(gòu)如下：

{
  "result": {
    "success": true,
    "productList": [
      {
        "productId": "商品ID",
        "title": "商品標(biāo)題",
        "imageUrl": "商品主圖URL",
        "similarity": 0.85, // 與查詢圖片的相似度
        "price": "價(jià)格",
        "minOrderQuantity": "最小起訂量",
        "sellerId": "賣家ID",
        "sellerName": "賣家名稱",
        "detailPageUrl": "商品詳情頁(yè)鏈接"
      },
      // ... 更多商品
    ],
    "totalResults": 100, // 匹配到的商品總數(shù)
    "page": 1,
    "pageSize": 20
  },
  "errorCode": "0", // 0表示成功
  "errorMessage": "success"
}

五、 注意事項(xiàng)

訪問(wèn)頻率限制： 注意開(kāi)放平臺(tái)的調(diào)用頻次限制，避免觸發(fā)流控。

圖片質(zhì)量： 圖片清晰度和主體突出程度直接影響搜索結(jié)果質(zhì)量。

錯(cuò)誤處理： 需處理常見(jiàn)錯(cuò)誤碼，如 400（參數(shù)錯(cuò)誤）、401（認(rèn)證失?。?00（服務(wù)端錯(cuò)誤）等。

分頁(yè)處理： 合理使用 page 和 pageSize 參數(shù)獲取更多結(jié)果。

授權(quán)管理： access_token 有過(guò)期時(shí)間，需實(shí)現(xiàn)令牌的刷新機(jī)制。

六、 應(yīng)用場(chǎng)景

電商比價(jià)工具

供應(yīng)鏈貨源查找

商品侵權(quán)檢測(cè)

移動(dòng)端拍照找貨應(yīng)用

通過(guò)合理調(diào)用此API，開(kāi)發(fā)者可以高效地整合1688的海量商品資源，為用戶提供便捷的以圖搜貨服務(wù)。

提示： 具體參數(shù)名稱、值范圍、錯(cuò)誤碼等請(qǐng)務(wù)必以1688開(kāi)放平臺(tái)官方文檔最新說(shuō)明為準(zhǔn)。在開(kāi)發(fā)前，建議先用平臺(tái)提供的測(cè)試賬號(hào)和工具進(jìn)行調(diào)試。

?
審核編輯 黃宇