阿里巴巴按图搜索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 返回的数据，并在应用中展示搜索结果，例如商品列表、商品详情页链接等。