条码查询接口使用教程
本接口服务详情页：点击进去
4. 功能特点
| 项目 | 说明 |
|---|---|
| 条码类型 | EAN-13、EAN-8、UPC-A、UPC-E，国内商品以 69 开头 13 位码为主 |
| 双接入点 | 通用商品条码查询 + 药品/保健条码查询 |
| 请求方式 | POST / GET |
| 返回格式 | JSON，统一封装在 res_body 中 |
| 通用字段 | 商品名称、品牌、规格、厂家、分类、参考价格、图片、尺寸、产地 |
| 药品字段 | 批准文号、主要成分、功能主治、用法用量、禁忌、注意事项 |
| 数据更新 | 条码库持续补充新商品数据 |
| 图片时效 | 返回图片链接有效期较短，建议业务侧下载后自行存储 |
药品/保健接入点额外返回医药专属字段，适合药店、医药电商及健康管理场景。
5. 操作流程
5.1 参数对照表
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | String | 是 | 商品条形码，支持 69 开头的 13 位或 069 开头的 14 位国内商品条码 |
5.2 五步接入流程
- 选择接入点：根据业务类型选择“条码查询”或“药品条码查询”接入点。
- 获取调用凭证：在控制台查看 AppKey，并在请求头中携带。
- 构造请求：使用
application/x-www-form-urlencoded格式，在 Body 中传入code参数。 - 在线调试：进入在线调试页，填写条码后点击运行，可即时查看返回结构。
- 解析响应：从
res_body中读取商品名称、品牌、规格、厂商、图片等字段并写入业务系统。
5.3 在线调试页面
下图展示了在线调试页中填写条码参数后的界面：
6. 实际案例
以下三条真实商品条码均查询成功，返回结果可用于商品建档。
6.1 怡宝饮用纯净水
| 字段 | 值 |
|---|---|
| 条码 | 6901285991219 |
| 商品名称 | 怡宝饮用纯净水 |
| 品牌 | 怡宝 |
| 规格 | 555 毫升 |
| 生产厂家 | 华润怡宝饮料(中国)有限公司 |
| 商品分类 | 食品、饮料和烟草 >> 饮料 >> 非酒精饮料 >> 泉水和矿泉水 |
6.2 脉动维生素饮料（香水柠檬口味）
| 字段 | 值 |
|---|---|
| 条码 | 6902538008159 |
| 商品名称 | 维生素饮料（香水柠檬口味） |
| 品牌 | 脉动 |
| 规格 | 450 毫升 |
| 生产厂家 | 达能(中国)食品饮料有限公司 |
| 商品分类 | 食品、饮料和烟草 >> 饮料 >> 非酒精饮料 >> 软饮料 |
6.3 伊利 QQ 星儿童成长牛奶（健固）
| 字段 | 值 |
|---|---|
| 条码 | 6907992510200 |
| 商品名称 | QQ星儿童成长牛奶――健固 |
| 品牌 | 伊利 |
| 规格 | 125mL×4（4 联包）利乐砖 |
| 生产厂家 | 内蒙古伊利实业集团股份有限公司 |
| 商品分类 | 食品、饮料和烟草 >> 乳制品和蛋 >> 牛奶和黄油产品 >> 贮藏的牛奶和黄油产品 |
7. 在线运行实录
7.1 场景设计
某社区便利店为新到货的瓶装水建立电子档案。店员在在线调试页输入条码 6901285991219，调用“条码查询”接入点，期望获取商品名称、品牌、规格与图片。
7.2 运行过程
- 请求参数：
code=6901285991219 - 请求方式：POST，同步返回，毫秒级响应
- 请求 ID：
6a6c3eedfb638c4dcf584ad2
填写参数后点击“Run”按钮，接口即时返回 JSON 数据。
7.3 结果解读
返回关键字段如下：
| 字段 | 值 | 说明 |
|---|---|---|
| ret_code | 0 | 查询成功 |
| goodsName | 怡宝饮用纯净水 | 商品标准名称 |
| trademark | 怡宝 | 品牌/商标 |
| spec | 555 毫升 | 规格 |
| manuName | 华润怡宝饮料(中国)有限公司 | 生产厂家 |
| goodsType | 食品、饮料和烟草 >> 饮料 >> 非酒精饮料 >> 泉水和矿泉水 | 标准商品类目 |
| img | 图片 URL | 商品主图，建议下载到本地后使用 |
响应中同时包含尺寸、形态描述、产地等附加字段，可供库存管理与详情展示使用。
8. 内容小结
- 条码查询接口通过单一
code参数即可返回商品主数据，接入成本低。 - 通用条码接入点适合零售、电商、仓储等场景；药品条码接入点额外提供医药专属字段。
- 返回图片链接有效期有限，生产环境建议下载后转存至自有存储。
- 请求头中需携带 AppKey，参数以
x-www-form-urlencoded格式提交。 - 在线调试页可用于快速验证条码数据，确认无误后再批量集成到业务系统。
更多参数与接入说明请参阅：请点击条码查询服务页
