适合企业 B 端采购寻源、样品比价场景，接口本质是传入图片，返回 1688 平台同款 / 相似货源，返回内容包含商品 ID、标题、主图、相似度、商家信息，再配合商品详情 API 拿到价格、MOQ、交期做比价.
一、先拿到接口权限（前置，必须企业资质）
- 使用企业认证的 1688 账号登录【阿里巴巴开放平台】
- 创建应用，拿到
app_key、app_secret（用于签名鉴权） - 在应用权限里单独申请 1688.item_search_img（拍立淘按图搜商品） 权限，申请用途可以填写「企业采购样品识图寻源、供应链比价」
- 权限审批通过后，会有调用配额、QPS 限流规则，批量寻源不能猛并发调用
二、图片准备与预处理（直接影响匹配精度，采购场景重点）
两种传图方式二选一：公网图片 URL（推荐）、图片 Base64 编码
图片规范：
- 格式：JPG/PNG，不支持 GIF、WebP
- 大小：建议控制在 1MB 以内，上限一般不超过 2MB
- 画面要求：样品主体居中，商品占画面大部分，尽量裁剪多余背景、去掉大面积水印反光；不要多件物品混拍，否则容易匹配跑偏
- 分辨率：短边至少 256px，实拍样品图不要过度压缩模糊
预处理操作（后端自动处理）：
采购上传样品原图 → 裁剪背景 → 压缩尺寸、画质 → 输出标准化图片；如果是 URL 方式，图片服务器不能有防盗链，否则 1688 服务端拉取不到图片。Base64 方式要去掉data:image/jpg;base64,前缀，清除换行空格。
三、构造请求参数，生成签名
网关地址固定：https://api.1688.com/router/rest，协议 HTTPS，POST 更稳，GET 只适合 URL 传图。
必填公共参数：
- method：固定
1688.item_search_img - app_key：开放平台应用 key
- timestamp：秒级时间戳，和平台服务器时间误差不能太大
- v：固定
2.0 - format：
json - sign_method：
md5 - sign：签名，规则：把所有参数按 key 字典排序，拼接
key+value，前后包裹 app_secret，再做 MD5 大写 - imgid：图片 URL 或者 清洗后的 Base64 字符串
可选业务参数（采购比价常用）：
- search_type：1 = 优先返回同款，0 = 相似款；样品寻源一般先用 1，找不到同款再切 0 找替代物料
- page、page_size：分页控制返回商品条数
- cat：类目 ID，有明确类目时传入，减少无关货源
四、发送请求，接收接口返回数据
返回 JSON 结构里的关键字段：
- 商品基础信息：itemId、商品标题、商品链接、商家名称、商家 id
- similarity：相似度分数，企业采购最核心字段，可以设置阈值，比如 85 分以上判定为同款样品，60~85 为相似替代件，低于 60 直接丢弃
- 主图、销量等简单信息
注意：拍立淘接口本身不返回阶梯价、起订量、样品费、交期。想要做比价表，拿到 itemId 之后，再调用【商品详情 API】批量拉取这些采购需要的字段。
五、业务层处理（采购寻源流程）
- 相似度过滤：过滤低分无效结果，只保留候选供应商
- 二次筛选：按采购规则过滤，比如过滤 MOQ 过高、不支持打样、发货地区不符合要求的商家
- 生成比价清单：把供应商、阶梯价格、样品费、交期、验厂资质整理成表格，可导出 Excel 给采购人员
- 人工复核：API 只是初筛，材质、公差、工艺要求必须采购和商家再次确认，不能直接作为下单依据
六、简易技术流程（采购系统嵌入）
前端上传样品图 → 后端图片清洗压缩 → 调用拍立淘 API 拿到商品列表 + 相似度 → 批量调用商品详情 API 获取报价 MOQ → 后台筛选排序，输出比价页面 / 报表
七、常见踩坑点
- 图片防盗链：URL 模式经常遇到平台无法下载图片，返回图片无效
- 签名时间戳误差：服务器时间不准直接报签名错误
- 高频批量调用：大量样品图一次性跑，触发限流 429，要做队列和延时
- 匹配不准：样品图反光、角度差异大、背景杂乱，需要前端引导采购尽量拍正面清晰图
- 权限问题：个人开发者无法开通，商用必须企业应用权限
