速卖通商品详情API:签名、多币种与库存物流避坑

速卖通商品详情API:签名、多币种与库存物流避坑

速卖通商品详情这个接口,我第一个跟头栽得挺冤枉。当时要做跨境比价,我想着商品详情嘛,传个 product_id 进去,价格、库存、物流应该一把全回来了。结果签名连续报401,错误信息只说Invalid Signature,不告诉你错在哪个参数。我对着文档逐字比对到半夜才发现,sign_method 漏了,时间戳还习惯性用了北京时间的 yyyy-MM-dd HH:mm:ss,而速卖通要求的是UTC时区的ISO格式。一个签名,卡了我六个小时。

后来链路跑通了,坑才刚开始。价格字段里藏着“折上折”,我只算了基础折扣价,漏了数量折扣,一单利润直接缩水几百刀。库存只取了 total_stock,没区分国内仓和海外仓,欧洲买家下单了国内仓的货,物流时效从3天变成15天,退款和投诉一起来。包邮字段当成“全地区包邮”用,沙特买家的运费全砸在自己手里。这三脚踩完,我才算把速卖通商品详情的链路彻底理顺了:价格不是一层折扣、库存不是一个总数、包邮不是所有地区,接口给的每一个字段,口径都比字面意思复杂。

先搞清楚你要调的是哪一套接口

速卖通开放平台有两套商品详情接口,选错了后面全白搭。

aliexpress.item.get 是商家自用接口,只能查你自己店铺的商品,查不了任何外部竞品。你要做选品、竞品监控、多平台铺货,从一开始就得走 aliexpress.solution.product.detail.get,这是联盟分销通用接口,能查全网公开商品,原生支持多语言多币种,网关走新加坡节点,访问也更稳定。两套接口的权限、能力、适用场景天差地别,选错了不是调不通的问题,是方向错了。

另外,个人开发者权限很低,完整商品数据基本拿不到,详情接口需要企业资质。服务器出口IP还要配白名单,没配直接403。这些前置条件不跑通,后面的代码写得再好都是空转。

签名:UTC时间加SHA256,两个都不能漏

签名这块是我踩得最深的一脚。速卖通的 timestamp 要求UTC时区的ISO格式,类似 2025-12-03T12:00:00Z,不是毫秒数,也不是本地时间。sign_method 必须显式写成 sha256,不写的话默认算法不是你以为的那个。format 固定为 json,v 固定为 2.0,漏一个都会报签名错误,但错误信息只字不提“参数缺失”。

完整的签名逻辑是:剔除 sign 和空值参数,按 key 的ASCII升序排列,拼成 key=value&key=value,值做URL编码,末尾拼接 app_secret,SHA256加密后转大写。注意速卖通不是把密钥放首尾两头,只在末尾加一次。服务器时间还得跟阿里云NTP同步,误差超过5分钟签名直接失败。

价格:三层嵌套加汇率,别拿除法硬算

价格字段的结构比你想象的深。original_price 是原价,discount_price 是基础折扣价,quantity_discounts 是数量折扣——买2件减5%、买5件减10%,是一层一层叠上去的。你只算基础折扣价,利润会算高;你只算第一档数量折扣,后面的阶梯又会漏掉。

更隐蔽的是多币种换算。汇率藏在 currency_rates 字段里,不是让你拿人民币除以7去估的。有实战记录算过一笔账:直接用除法估汇率,和实际接口返回差0.02,1000件商品就差200刀。价格解析必须从 currency_rates 里取目标币种的汇率,再乘到价格上,不能自己拍脑袋换算。

库存和物流:仓库分三类,包邮分地区

库存不是“一个总数”那么简单。速卖通的库存拆成三块:domestic_stock(国内仓)、overseas_stocks(海外仓,按国家分)、pre_order_stock(预售)。你只取 total_stock,欧洲买家下单了国内仓的货,物流时效从3天变成15天,退款和投诉是必然的。库存解析得按目标国家去匹配海外仓,标清楚每个仓库的发货时效,买家预期才对得上。

包邮也是同理。is_free_shipping 为 true 不等于全地区包邮,free_shipping_countries 字段里写着到底哪些国家免运费。沙特不在列表里,你按包邮处理,500刀运费自己扛。物流解析要把目标国家传进去,先判断包邮范围,再算运费模板和时效,不能拿一个布尔值定全局。

SKU和限流:详情给框架,频率是硬约束

商品详情返回的 sku_info_list 里有每个规格的 sku_id、sku_price、stock 和属性组合,够你做规格层面的梳理。但要注意,部分高敏感字段(比如真实底层库存)有权限门槛,个人应用拿不到。拿“返回空”当“没规格”处理,会把正常商品误判成异常。

限流是另一个硬约束。个人开发者默认每天100次调用,企业开发者500次,免费应用QPS限制在2左右,短时间大量请求直接吃限流。批量拉取必须做间隔休眠,不能拿循环硬怼。

新媒体平台api数据接口

极致了数据在跨境电商数据采集这块,把签名、多币种换算、仓库拆分这些麻烦事封装掉了。速卖通商品详情支持按 product_id 批量拉取,价格带币种字段、库存分仓库返回、物流按国家区分,结构化JSON拿回来直接进表做筛选和比价,不用你自己去拼签名和拆汇率。接入方式按手里的牌选:有技术团队直接对接API;不想写代码的用飞书「多平台数据采集助手」插件零代码配采集任务;纯业务需求找客服定制数据表。

总结

速卖通商品详情API这件事,第一课不是“怎么调通”,是“签名用UTC加SHA256,价格折上折算汇率,库存分仓库,包邮分地区”。aliexpress.solution.product.detail.get 是查全网商品的入口,item.get 只管自己店铺。签名漏 sign_method 或时间戳格式不对,401不会告诉你错在哪。价格要叠数量折扣、从 currency_rates 取汇率,库存要匹配目标国家的海外仓,包邮要看 free_shipping_countries。个人权限有限,企业资质是硬门槛,限流按天算,批量任务先把配额和间隔算清楚。先把这几个口径对齐,再谈数据怎么用。

上一篇:

下一篇:

相关新闻

客服微信

联系我们

18658854422

微信号: wx2026-maxiao

邮件:474804@qq.com

工作时间:周一至周五,9:00-18:00,节假日休息