TAOCARTS 知识

对接货源API 的那两周:从以图搜货到商品自动入库

2026-07-21 博客文章

上一份工作我做电商中台,这次跳进 跨境电商 才知道,反向海淘 最难啃的不是前端,是把上游的货接进来。海外客户甩一张图过来问这哪买,你总不能真去人肉翻淘宝。

需求很直接:对接 货源API,实现以图搜货、一键采集商品图和价格、SKU 落库。淘宝和 1688 的接口字段并不一致,价格还分阶梯、含不含税也要判断,我们花了两周才把映射层理顺。

我们没自建整条链路,而是用 Taocarts 这套 SaaS系统 打底——它是现成的 代购系统 / 跨境电商平台,1688代采、海外仓、集运系统、多语言、多币种 都在后台备好了,我只需要把货源这一层接稳,其余模块拿来即用。

以图搜货的请求和返回,简化后大概长这样,返回的 SKU 直接进我们的入库队列。

GET /api/source/search?image={url}

-> { itemId, title, price, sku:[{id, spec, stock}] }

queue.push(mapToLocalSku(resp));   // 映射后入库

上游数据脏是常态:同款不同店价格能差三成,图片带水印,库存还会瞬时归零。我们加了去重、水印检测和库存回源校验,把明显异常的商品拦在入库前,避免海外客户下单后才发现缺货。这一层做扎实了,客诉直接少了一大半。

中间还踩过限流的坑。上游对单 IP 的采集频率有硬上限,我们加了一层本地限速加代理轮换,白天按正常节奏跑、凌晨加大批量补采。监控上做了成功率看板,哪条货源通道掉到九成以下就自动切备用接口,所以那两周我基本是看着曲线喝咖啡,没怎么救火。真正麻烦的是图片版权,淘宝图带水印不能直接用,我们顺手接了去水印加本地化存储,海外客户看到的就是干净的商品图了。这层做完,以图搜货到入库的整条链路才算真正闭合,我再也不用半夜爬起来手动救图了。

跑通那天正好赶上一个大阪客户批量下单文创,系统自动比价、自动锁库,我在旁边一行代码没动。那种把脏活交给接口的踏实感,比多写一千行业务逻辑都香。