阿里巴巴按圖搜索1688商品（拍立淘）API 返回值說明
阿里巴巴按圖搜索1688商品（拍立淘）API 的返回值通常以 JSON 格式返回，包含搜索結果、商品信息、分頁信息等。以下是具體的返回值說明：
1. 請求狀態信息
code：狀態碼，通常為?200?表示請求成功，其他值表示錯誤（如?401?表示未授權，429?表示請求頻率過高）。msg：請求狀態描述信息，例如?"success"?表示成功，"Unauthorized"?表示未授權。request_id：請求的唯一標識符，用于追蹤和調試請求。
2. 搜索結果信息
items：商品列表，包含搜索到的商品信息，每個商品為一個對象，包含以下字段：num_iid：商品 ID，1688 平臺上商品的唯一標識。title：商品標題，商品的名稱或簡短描述。pic_url：商品主圖 URL，商品的圖片地址。price：商品價格，商品的售價。original_price：商品原價（如有）。promotion_price：促銷價（如有）。sales：商品銷量，商品的累計銷量。seller_nick：賣家昵稱，提供該商品的店鋪名稱。area：賣家所在地，商品的發貨地或賣家所在地。detail_url：商品詳情頁 URL，點擊后跳轉到商品詳情頁面。similarity_score（可選）：相似度得分，表示上傳圖片與商品的相似程度（通常為 0 到 1 之間的浮點數）。
3. 分頁信息
page_size：每頁返回的商品數量。page_number：當前頁碼。total_results：搜索結果的總商品數量。total_pages：總頁數。
4. 錯誤信息（如有）
error：錯誤信息，包含錯誤代碼和錯誤描述。例如：json復制代碼{"error": {"code": 401,"message": "Unauthorized: Invalid API Key"}}
5. 示例返回值
以下是一個示例返回值：
json復制代碼
{ | |
"code": 200, | |
"msg": "success", | |
"request_id": "12345abcde", | |
"items": [ | |
{ | |
"num_iid": "6789012345678", | |
"title": "2024新款秋冬加絨衛衣", | |
"pic_url": "https://img.alicdn.com/imgextra/i1/123456789/O1CN01XXXXXXXXX_XX.jpg", | |
"price": "89.00", | |
"original_price": "129.00", | |
"promotion_price": "79.00", | |
"sales": 1234, | |
"seller_nick": "某某旗艦店", | |
"area": "廣東 廣州", | |
"detail_url": "https://detail.1688.com/offer/123456789.html", | |
"similarity_score": 0.95 | |
}, | |
{ | |
"num_iid": "8765432109876", | |
"title": "秋冬加絨連帽衛衣女", | |
"pic_url": "https://img.alicdn.com/imgextra/i2/234567890/O1CN01YYYYYYYYY_XX.jpg", | |
"price": "99.00", | |
"original_price": "159.00", | |
"promotion_price": "89.00", | |
"sales": 567, | |
"seller_nick": "某某服飾店", | |
"area": "浙江 杭州", | |
"detail_url": "https://detail.1688.com/offer/234567890.html", | |
"similarity_score": 0.92 | |
} | |
], | |
"page_size": 10, | |
"page_number": 1, | |
"total_results": 25, | |
"total_pages": 3 | |
} |
6. 注意事項
- 權限與認證：使用拍立淘 API 需要申請 API Key，并確保 API Key 具有調用權限。可以通過萬邦開放平臺獲取Key賬號和調用權限。
- 請求頻率限制：API 調用有頻率限制，超出限制可能會返回?
429 Too Many Requests?錯誤。 - 圖片要求：上傳的圖片需清晰、完整，以提高識別準確率。
- 數據準確性：搜索結果可能因圖片質量、算法匹配度等因素而有所差異。
通過以上返回值說明，開發者可以解析 API 返回的數據，并在應用中展示搜索結果，例如商品列表、商品詳情頁鏈接等。
