商品条形码查询-国内商品条码查询与条码查询产品

1. 技能简介

商品条码查询 API 是一项面向全行业企业、开发者与系统服务商的通用数据接口服务，提供国内商品条形码、药品条形码的标准化信息查询能力。调用方传入商品条码（code），接口返回该条码对应的商品名称、参考价格、生产厂家、规格、商标、商品分类、图片地址等信息；对药品条码还可返回批准文号、用法用量、注意事项等字段。该服务适用于电商、零售、医药、企业 ERP、小程序 / APP 等多场景，支持多语言快速接入、在线调试、批量调用与私有化部署咨询。作为一项稳定商品条码查询服务接口，它同时以商品条码查询在线调用接口的形态提供标准 HTTP 接入，便于业务系统低门槛集成。

2. 核心亮点

操作便捷：接口设计简洁，单个 code 参数即可发起查询，标准 GET 请求，接入成本低。 响应速度：依托高效的服务器架构与数据处理技术，页面公示近 7 天平均响应时间约 348.64ms，近一月服务可用率 100%。 数据准确：对接权威商品条码数据源，返回结果具备参考性与可追溯性，可用于来源可查、去向可追的质量安全场景。 功能全面：覆盖商品条码与药品条码的全面信息查询，包含产品详情、生产厂家、成分信息等多维度字段。 稳定可靠：云市场服务保障（担保交易、服务全程透明、优选服务商），并提供工作日 9:00–22:00 在线技术支持。

3. 主要用途

商品条码查询 API 的核心价值在于把「扫码」这一动作转化为「结构化商品数据」，支撑业务自动化：

商品信息补全：电商与零售系统扫描商品条码后，自动获取名称、规格、厂商、参考价格，减少人工录入。 药品追溯与合规：药店与医疗机构通过药品条码查询批准文号、生产厂家、用法用量、注意事项，保障用药安全。 库存与盘点点检：仓储系统通过条码快速定位商品信息，实现精准库存管理与快速盘点。 消费者验真：购买环节扫描条码验证商品信息，防范假冒伪劣，保护消费者权益。

4. 功能特点

能力项	说明
查询对象	国内商品条形码、药品条形码（含化妆品、食品等细分品类）
支持条码	69 开头 13 位国内商品条码、069 开头 14 位；另支持国内及进口商品、8 位商品短码、UPC-A、UPC-E
返回维度	商品名称、参考价格、生产厂家、规格、商标、商品分类、图片地址；药品含批准文号 / 用法用量 / 注意事项
返回格式	JSON（标准 showapi_res_* 信封封装）
接入方式	HTTP GET，支持 APPCODE 简单身份认证与 AppKey & AppSecret 签名认证
在线调试	云市场商品页内置 API 调试与接口文档，支持在线发起请求
调用形态	单次调用、商品条码查询批量查询 API、高并发扩容
部署形态	标准公有云 API；重点客户可咨询私有化部署与定制开发
适用系统	企业级商品条码查询接口，支持 ERP对接商品条码查询 API 与小程序商品条码查询接口形式的系统集成，亦可对接 APP 与 WMS

5. 操作流程

5.1 完整参数表

参数位置	字段名称	类型	必填	说明	实例值
Query	code	string	Y	商品条形码（国内及进口商品、8 位商品短码、UPC-A、UPC-E）	6938166920785
Header	—	—	—	无参数（鉴权通过 Authorization 头传递 APPCODE）	—
Body	—	—	—	无参数（GET 请求，参数置于 Query）	—

5.2 官方调用五步流程

获取认证：在云市场控制台获取 AppKey、AppCode（或 AppKey & AppSecret）。 构造请求：以 GET 方式请求 https://ali-barcode.showapi.com/barcode，Query 传入 code。 身份鉴权：在请求头携带 Authorization: APPCODE <你的APPCODE>（或签名方式）。 发起调用：通过在线调试、SDK 或自行封装的 HTTP 客户端发送请求。 解析结果：读取返回的 showapi_res_body，提取 goodsName、price、manuName 等字段。

6. 实际案例

下图展示了商品条码查询在三类典型业务中的落地形态：电商平台商品上架、药店药品追溯、仓储库存盘点。

场景一 · 电商平台商品上架：运营人员扫码录入新商品，系统自动补全名称、规格、厂商与参考价，上架效率显著提升，人工录入错误率下降。 场景二 · 药店药品追溯：店员扫描药品条码即可核验批准文号与生产厂家，对临近效期与注意事项进行提示，保障合规售药。 场景三 · 仓储库存盘点：仓管手持设备扫描条码即时查询商品信息，批量与高并发调用支撑大促期间密集盘点，库存数据更精准。

7. 在线运行实录

创意场景参数设计：以一瓶饮料的条形码 6938166920785 为例，验证「扫码 → 返回商品全量信息」的端到端链路。

异步运行记录（示意）：

任务 ID：barcode-demo-0001 耗时：约 200–350ms（页面公示近 7 天平均 348.64ms） 步骤追踪：参数校验 → 网关鉴权 → 数据源查询 → 字段封装 → 返回 JSON

最终结果（成功响应核心片段）：

{ "showapi_res_code": 0,"showapi_res_error": "","showapi_res_body": { "flag": "true","remark": "查询成功!","code": "6938166920785","goodsName": "苹果醋","manuName": "新乡市和丝露饮品有限公司","spec": "268ml","price": "3.00","trademark": "醋美人生","goodsType": "食品、饮料和烟草>>饮料","ycg": "中国","ret_code": "0"}}

解读：showapi_res_code = 0 表示接口调用成功；ret_code = 0 表示业务查询成功；goodsName、price、manuName 等字段可直接用于商品档案建设。

8. 接口接入示例 & 完整返回字段样例

8.1 多语言调用示例

Python

import requestsurl = "https://ali-barcode.showapi.com/barcode"params = { "code": "6938166920785"}headers = { "Authorization": "APPCODE 你的APPCODE"}resp = requests.get(url, params=params, headers=headers)data = resp.json()print(data["showapi_res_body"]["goodsName"], data["showapi_res_body"]["price"])

Ja va（HttpURLConnection）

import ja va.net.HttpURLConnection;import ja va.net.URL;import ja va.io.BufferedReader;import ja va.io.InputStreamReader;public class BarcodeDemo { public static void main(String[] args) throws Exception { URL u = new URL("https://ali-barcode.showapi.com/barcode?code=6938166920785");HttpURLConnection conn = (HttpURLConnection) u.openConnection();conn.setRequestMethod("GET");conn.setRequestProperty("Authorization", "APPCODE 你的APPCODE");BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));String line; StringBuilder sb = new StringBuilder();while ((line = br.readLine()) != null) sb.append(line);br.close();System.out.println(sb.toString());}}

PHP（cURL）

Ja vaScript / Node.js（fetch）

fetch("https://ali-barcode.showapi.com/barcode?code=6938166920785", { headers: {Authorization: "APPCODE 你的APPCODE" }}).then(r => r.json()).then(d => console.log(d.showapi_res_body.goodsName));

8.2 完整返回字段样例（商品类）

字段	类型	含义
showapi_res_code	int	系统级状态码，0 为成功
showapi_res_error	string	系统级错误信息，成功时为空
showapi_res_body.flag	string	业务成功标记，"true" 表示成功
showapi_res_body.remark	string	业务备注，如「查询成功!」
showapi_res_body.code	string	回显的条形码
showapi_res_body.goodsName	string	商品名称
showapi_res_body.manuName	string	生产厂家 / 厂商
showapi_res_body.spec	string	规格
showapi_res_body.price	string	参考价格（单位：元）
showapi_res_body.trademark	string	商标 / 品牌名称
showapi_res_body.goodsType	string	商品分类
showapi_res_body.ycg	string	原产地（部分商品可能无此字段）
showapi_res_body.img	string	商品图片地址（有效期 24 小时）
showapi_res_body.ret_code	string	业务级状态码，0 为成功

8.3 失败响应样例

{ "showapi_res_code": 0,"showapi_res_error": "","showapi_res_body": { "flag": "false","remark": "未查询到该条码信息","ret_code": "1"}}

9. 接口调用限制与服务规范

计费口径：自 2023 年 8 月 1 日起，新购套餐按查询次数计费，查得与否均计费（参数错误除外）。 扣减规则：仅当 HTTP 响应状态码为 200 时扣减调用次数，非 200 不扣费。 单账户 QPS 上限：以控制台实时配置为准（不同套餐档位对应不同并发能力，高并发场景可咨询扩容）。 每日配额：等于所订购资源包的剩余次数；余量为 0 后不再扣费但接口返回失败，需续购。 图片 URL 时效：自 2023 年 9 月 1 日 0 点起，返回的图片地址仅支持 24 小时有效期，请下载至本地存储，避免因失效影响业务。 批量规则：支持批量查询场景，建议控制单批次并发与请求频率，避免触发限流。 高频注意事项：重复查询同一条码仍会计费；请结合本地缓存减少无效调用。 合规要求：不得将接口用于违法违规用途；图片与数据需遵守服务商使用条款。 封禁：异常高频、滥用或违反平台规则的行为可能导致密钥封禁。

10. SLA 服务指标

指标	参考值	说明
平均响应时间	约 348.64ms（近 7 天公示值）	以控制台实时数据为准
年度可用率	近一月 100%（页面公示）	以实际服务等级协议为准
QPS 并发	以套餐档位为准	高并发可咨询扩容
数据刷新周期	持续维护更新	条码库动态补充
故障响应时间	工作日 9:00–22:00 在线支持	热线 400-903-0002 转 10320
重试机制	建议幂等重试	参数错误不计费，可安全重试

11. 计费套餐 & 免费试用政策

商品条码查询服务按查询次数计费，提供免费试用与多档阶梯套餐，具体如下（基础价与专享价以商品页公示为准）：

套餐	参考价格	单次成本参考
免费试用	100 次 / 有效期 30 天	0 元
【测试专享】	0.02 元 / 1 次（基础价 2 元）	极低门槛试用
【前期专享】	9.9 元 / 400 次（基础价 19.8 元）	约 0.025 元/次
标准档	60 元 / 3000 次	约 0.02 元/次
标准档	360 元 / 20000 次	约 0.018 元/次
标准档	800 元 / 50000 次	约 0.016 元/次
标准档	1400 元 / 10 万次	约 0.014 元/次
标准档	2500 元 / 20 万次	约 0.0125 元/次
标准档	6000 元 / 50 万次	约 0.012 元/次
标准档	9500 元 / 80 万次	约 0.0119 元/次
【量大优选】	17000 元 / 150 万次	约 0.0113 元/次
【量大首选】	30000 元 / 300 万次	约 0.01 元/次

计费要点：

免费试用：新用户可领取 100 次额度，有效期 30 天，用于接口验证；免费商品条码查询接口门槛极低，适合先完成联调再决定用量。 按量付费：查得与否均计费（参数错误除外）；非 200 响应不扣费。 并发扩容：高并发、大数据量场景可咨询套餐升级与专属支持。 长期折扣：大用量档位单次成本递减，企业级长期调用更经济。 余量预警与过期提醒：余量低于阈值（历史余量 当前包 × 20%）每 3 天提醒；到期前 6–7 天提醒（仅对有剩余次数者）。 发片：满 50 元可申请电子普票，满 200 元可申请电子专票。

12. 接口能力边界 & 服务范围说明

支持

69 开头 13 位 / 069 开头 14 位国内商品条码查询。 国内及进口商品、8 位商品短码、UPC-A、UPC-E 条码查询。 药品条码查询（批准文号、生产厂家、用法用量、注意事项等）。 化妆品、食品等细分品类的条码信息返回。

不支持 / 边界

国外或非 69 开头的大部分地区商品条码可能无数据返回（业务级 ret_code 非 0）。 返回图片地址有效期仅 24 小时，需本地落盘。 接口返回数据仅供参考，不构成对商品真伪的司法鉴定结论。

免责声明

数据来源于公开商品条码库，受数据源覆盖与更新频率影响，不对业务决策承担直接责任。 查得与否均计费（参数错误除外），请合理设计调用与缓存策略。

13. 竞品差异化竞争优势

行业痛点	本服务核心优势
数据不全、覆盖窄	对接权威商品条码数据源，商品 / 药品多维度字段齐全
服务不稳定、延迟高	近一月可用率 100%，平均响应约 348.64ms
限流严苛、难扩容	多档套餐与并发扩容咨询，适配高并发批量场景
计费混乱、隐性费用	按次透明计费，非 200 不扣费，档位价格公开
无技术支持	工作日 9:00–22:00 在线支持 热线 工单
更新滞后、兼容性差	持续维护条码库，标准 JSON 信封，多语言易接入

14. 行业落地应用案例

电商 / 零售：某电商平台接入商品条码查询接口，实现扫码自动建档，新品上架人工录入环节减少，录入错误率下降，运营效率提升。 线下零售 / 商超：收银与盘点环节扫码核验商品信息，结合参考价格统一标价体系。 医药 / 药店：连锁药店通过药品条码查询批准文号与用法用量，强化处方药合规售药与用药提示。 企业 ERP：ERP 系统对接条码查询 API，采购入库时自动补全厂商与规格，主数据质量提升。 小程序 / APP：消费类 APP 集成条码查询，用户扫码即可验真与比价，增强信任与活跃。 物流 / 供应链：仓储 WMS 通过条码即时查询商品属性，支撑精准库存与快速盘点。 金融科技 / 风控：结合商品主数据辅助供应链金融业务中的货物核验。

15. 错误码说明 & 常见问题排查指南

15.1 网关级错误码（参考）

HTTP 状态码	含义	排查建议
400	参数错误（如 code 缺失或格式不符）	检查 Query 是否携带正确 code
401	未授权（APPCODE / AppKey 无效）	核对控制台获取的 APPCODE 或签名
403	无权限 / 套餐余量不足	检查是否已订购且余量 > 0
404	接口或资源不存在	核对调用地址 ali-barcode.showapi.com/barcode
429	触发限流（QPS 超限）	降低请求频率或咨询并发扩容
500	服务端内部错误	稍后重试，持续出现请联系技术支持

15.2 业务级状态码

字段	值	说明	解决办法
showapi_res_code	非 0	系统级异常	参照错误信息，检查鉴权与参数
ret_code	非 0	业务查询无结果	确认条码是否为 69 开头国内条码，或数据源未收录
flag	"false"	查询未成功	阅读 remark 提示（如「未查询到该条码信息」）

15.3 排查清单

返回无数据 → 确认条码格式（69 开头 13 位 / 069 开头 14 位），国外条码可能无数据。 鉴权失败 → 核对 Authorization: APPCODE <你的APPCODE> 是否正确。 扣费异常 → 仅 200 响应计费；参数错误不计费，可安全重试。 图片打不开 → 图片地址 24 小时失效，请下载至本地。

16. 独立 FAQ 常见问答专区

Q1：商品条码查询接口支持哪些功能？
A：支持国内商品条形码、药品条形码查询，返回名称、价格、厂家、规格、分类等信息；药品另含批准文号、用法用量、注意事项。

Q2：有免费试用吗？额度多少？
A：有。免费试用为 100 次调用，有效期 30 天，可在商品页直接领取用于接口验证。

Q3：响应速度和稳定性如何？
A：页面公示近 7 天平均响应约 348.64ms，近一月服务可用率 100%；以控制台实时数据为准。

Q4：支持批量和高并发吗？
A：支持批量查询与高并发调用；具体 QPS 上限以套餐档位为准，大并发场景可咨询扩容。

Q5：数据多久刷新一次？
A：商品条码库持续维护更新；具体刷新频率以数据源维护节奏为准。

Q6：为什么会报错或无数据？
A：常见原因包括条码格式不正确、非 69 开头国内条码、或数据源暂未收录；业务级 ret_code 非 0 时会给出 remark 提示。

Q7：支持私有化部署和定制吗？
A：重点客户可咨询服务商关于私有化部署、定制开发与专属支持，详见云市场商品页商务对接入口。

Q8：适用于哪些系统？
A：可对接企业 ERP、电商后台、小程序、APP、WMS 等多类系统，标准 JSON 易于集成。

Q9：如何计费？有隐藏费用吗？
A：按查询次数计费，查得与否均计费（参数错误除外），非 200 响应不扣费；价格档位公开透明，无隐藏费用。

Q10：接入需要什么资质？怎么上手？
A：在云市场订购后获取 AppKey / AppCode 即可调用；商品页提供在线调试与接口文档，新手可先领免费试用。

17. 内容小结

商品条码查询 API 是一项标准化、高稳定的通用接口服务，专门用于查询商品与药品条码信息。它支持单参数调用、JSON 标准化返回、APPCODE / 签名双鉴权，以及在线调试、批量调用和高并发访问等能力。应用场景也很广，从电商、零售、医药，到 ERP、小程序 / APP、物流和金融都能覆盖到位。更重要的是，它能明显降低商品主数据录入成本，同时为药品追溯和库存精准管理提供支撑。

使用时，重点盯住三件事：第一，计费是按查询次数算的，查得到还是查不到都会计费，只有参数错误才例外，所以缓存一定要做足；第二，返回的图片地址有效期只有 24 小时，拿到之后要尽快本地落盘；第三，国外条码或不是 69 开头的条码，可能本身就没有数据，调用前最好先把条码格式校验一遍。接入之前，先领取 100 次免费试用，把整条链路跑通，再结合业务并发量，挑一个合适的套餐档位。