商品条码查询API实战：5分钟接入GS1数据，Python与JS双语言示例

原创于 2026-06-25 11:00:51 发布 · 309 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#商品条码 #API开发 #GS1 #Python #JavaScript

API开发同时被 2 个专栏收录

33 篇文章

订阅专栏

实用工具

1 篇文章

订阅专栏

为什么需要商品条码查询 API？

商品条码（Barcode）是商品流通的“身份证”，全球通用的 GS1 标准条码（如 EAN-13、UPC-A）承载着品牌、规格、产地等关键信息。对于电商平台、库存管理系统、扫码工具类应用，能够快速根据条码获取商品详情，是提升用户体验和运营效率的核心功能。

传统做法是自建数据库或人工维护，但更新慢、覆盖不全。接入第三方 API（如极数本源提供的商品条码查询 PRO API）可以零成本获取权威数据，5 分钟内完成集成。

准备：注册与获取 API Key

以极数本源平台为例（一家聚合数百个高质量 API 的工具集市），接入前需要：

注册账号并登录。
在 API 商城搜索“商品条码查询”，找到对应服务并订阅（通常有免费测试额度）。
在控制台 → 我的密钥中复制 AppKey（或 API Key）。

大多数聚合平台会提供统一的签名认证方式，而部分 API 采用简单 Header 传参。本文假定使用极数本源的标准认证方式：在请求头中携带 X-Api-Key。

API 接口详情

请求地址

GET https://api.apizero.cn/v1/barcode/query

请求参数

参数名	类型	必填	说明
barcode	string	是	13 位 EAN-13 或 12 位 UPC-A 商品条码
appkey	string	是	平台分配的 API 密钥

实际调用时，appkey 也可以放在 Header 中，避免明文暴露。本文示例均采用 Header 方式。

返回格式

{
  "code": 0,
  "msg": "success",
  "data": {
    "barcode": "6901234567890",
    "name": "示例商品名称",
    "brand": "品牌名",
    "spec": "500ml",
    "category": "饮料/茶饮",
    "image": "https://img.example.com/123.jpg",
    "price": "12.50"
  }
}

注：实际字段可能更多，如生产厂家、产地、参考价格等，请以官方文档为准。

Python 调用示例

使用 requests 库，代码简洁明了：

import requests

# API 配置
API_URL = "https://api.apizero.cn/v1/barcode/query"
API_KEY = "your_appkey_here"  # 替换为你的密钥

def query_barcode(barcode: str) -> dict:
    headers = {
        "X-Api-Key": API_KEY,
        "Accept": "application/json"
    }
    params = {
        "barcode": barcode
    }
    try:
        resp = requests.get(API_URL, headers=headers, params=params, timeout=10)
        resp.raise_for_status()
        result = resp.json()
        if result.get("code") == 0:
            return result["data"]
        else:
            raise ValueError(f"API 返回错误：{result.get('msg')}")
    except requests.exceptions.RequestException as e:
        raise RuntimeError(f"网络请求失败: {e}")

if __name__ == "__main__":
    barcode = "6901234567890"
    try:
        product = query_barcode(barcode)
        print(f"商品名称: {product['name']}")
        print(f"品牌: {product['brand']}")
        print(f"规格: {product['spec']}")
        print(f"参考价格: {product['price']} 元")
    except Exception as e:
        print(f"查询失败: {e}")

运行前请安装 requests：

pip install requests

JavaScript/Node.js 调用示例

使用 fetch 或 axios。下面是用 Node.js 原生 https 模块实现的示例（避免第三方依赖）：

const https = require('https');

function queryBarcode(barcode, apiKey) {
  return new Promise((resolve, reject) => {
    const url = new URL('https://api.apizero.cn/v1/barcode/query');
    url.searchParams.append('barcode', barcode);

    const options = {
      hostname: url.hostname,
      path: url.pathname + url.search,
      method: 'GET',
      headers: {
        'X-Api-Key': apiKey,
        'Accept': 'application/json'
      }
    };

    const req = https.request(options, (res) => {
      let data = '';
      res.on('data', chunk => data += chunk);
      res.on('end', () => {
        try {
          const result = JSON.parse(data);
          if (result.code === 0) {
            resolve(result.data);
          } else {
            reject(new Error(`API error: ${result.msg}`));
          }
        } catch (e) {
          reject(new Error('JSON parse failed'));
        }
      });
    });

    req.on('error', (e) => reject(e));
    req.end();
  });
}

// 使用示例
const API_KEY = 'your_appkey_here';
const BARCODE = '6901234567890';

queryBarcode(BARCODE, API_KEY)
  .then(product => {
    console.log(`商品名称: ${product.name}`);
    console.log(`品牌: ${product.brand}`);
  })
  .catch(err => console.error('查询失败:', err));

如果使用现代浏览器或 Node 18+，可以直接用 fetch（需注意跨域和 CORS），代码更简洁：

async function queryBarcode(barcode) {
  const res = await fetch(`https://api.apizero.cn/v1/barcode/query?barcode=${barcode}`, {
    headers: { 'X-Api-Key': API_KEY, 'Accept': 'application/json' }
  });
  const result = await res.json();
  if (result.code !== 0) throw new Error(result.msg);
  return result.data;
}

常见错误处理

错误码	含义	解决方法
1001	无效条码格式	检查条码是否为 12/13 位数字
1002	条码不存在	确认条码已注册或尝试其他条码
1003	API Key 无效	检查密钥是否正确且未过期
1004	调用频率超限	降低请求频率，或升级套餐
2001	服务器内部错误	稍后重试，或联系支持