引言

商品条码（GS1）是商品的全球唯一标识，广泛应用于零售、物流、电商等场景。开发者经常需要根据条码查询商品名称、品牌、规格、价格等信息。手动维护数据库效率低且不实时，而调用专业API接口是最佳方案。

APIZero（极数本源）聚合了数百个高质量API，其中商品条码查询PRO接口专为批量、高精度查询设计。本文将从在线调试到代码集成，带你全面掌握该接口的使用方法。

1. 接口概述

1.1 接口地址

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

1.2 请求方式与认证

• 请求方式：GET
• 认证方式：API Key（需在APIZero平台注册并获取AppKey）
• 数据格式：JSON

1.3 请求参数

参数名	类型	必填	说明	示例值
appkey	string	是	平台分配的API秘钥	sk_abc123
barcode	string	是	商品条码（GS1-13或EAN-8）	6901234567890
type	string	否	返回数据格式（json/xml），默认json	json

注意：每个AppKey有调用次数限制，请合理规划；单次查询仅支持单个条码，批量查询需循环调用。

2. 在线调试

APIZero平台提供了在线调试功能，无需编写代码即可验证接口。

2.1 进入调试页面

登录APIZero控制台，在“API商城”搜索“商品条码查询”，点击“在线调试”。

2.2 填写参数并发送

• 在“AppKey”输入框填入你的秘钥
• 在“barcode”输入框填入测试条码，例如 6901234567890
• 点击“发送请求”

2.3 查看返回结果

平台会即时显示HTTP状态码、响应头和响应体。例如：

{
  "code": 0,
  "message": "success",
  "data": {
    "barcode": "6901234567890",
    "name": "示例商品",
    "brand": "示例品牌",
    "spec": "500ml",
    "price": "29.90",
    "image": "https://img.apizero.cn/goods/6901234567890.jpg",
    "category": "饮料"
  }
}

调试成功后，即可将相同参数用于代码集成。

3. 代码调用示例

以下分别展示Python、JavaScript（Fetch）以及cURL的完整调用方式。

3.1 Python 示例

使用 requests 库，安装命令：pip install requests

import requests

def query_barcode(appkey, barcode):
    url = "https://api.apizero.cn/barcode/query"
    params = {
        "appkey": appkey,
        "barcode": barcode
    }
    try:
        resp = requests.get(url, params=params, timeout=10)
        resp.raise_for_status()
        return resp.json()
    except requests.exceptions.RequestException as e:
        print(f"请求失败: {e}")
        return None

if __name__ == "__main__":
    APPKEY = "your_appkey_here"
    BARCODE = "6901234567890"
    result = query_barcode(APPKEY, BARCODE)
    if result and result.get("code") == 0:
        data = result["data"]
        print(f"商品名称: {data['name']}")
        print(f"品牌: {data['brand']}")
        print(f"规格: {data['spec']}")
        print(f"价格: {data['price']}")
    else:
        print("查询失败:", result)

3.2 JavaScript (Fetch) 示例

适用于浏览器端或Node.js（需安装 node-fetch）。

const API_URL = 'https://api.apizero.cn/barcode/query';
const APPKEY = 'your_appkey_here';
const BARCODE = '6901234567890';

async function queryBarcode() {
    const params = new URLSearchParams({
        appkey: APPKEY,
        barcode: BARCODE
    });
    try {
        const response = await fetch(`${API_URL}?${params}`);
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        const data = await response.json();
        console.log('返回数据:', data);
        if (data.code === 0) {
            const item = data.data;
            console.log(`商品：${item.name}`);
            console.log(`品牌：${item.brand}`);
            console.log(`价格：${item.price}`);
        }
    } catch (error) {
        console.error('请求失败:', error);
    }
}

queryBarcode();

3.3 cURL 示例

用于快速调试或脚本环境：

curl -X GET "https://api.apizero.cn/barcode/query?appkey=your_appkey_here&barcode=6901234567890"

4. 返回数据与字段说明

成功时HTTP状态码为200，响应体结构如下：

字段	类型	说明
code	int	业务状态码，0表示成功
message	string	提示信息
data	object	商品信息对象（见下表）

data对象字段：

字段	类型	说明	示例
barcode	string	条码号	6901234567890
name	string	商品名称	可口可乐
brand	string	品牌	可口可乐
spec	string	规格	330ml
price	string	参考价格（元）	3.50
image	string	商品图片URL	http://xxx.jpg
category	string	分类（部分商品有此字段）	饮料

5. 常见错误码与处理

HTTP状态码	业务code	说明	处理建议
200	0	成功	正常使用
200	1001	AppKey无效	检查AppKey是否正确或是否过期
200	1002	条码格式错误	确保条码为纯数字，长度13或8位
200	1003	未找到该条码信息	尝试其他条码或确认条码是否录入
200	1004	调用频率超限	降低请求频率或升级套餐
200	1005	账户余额不足	充值或购买流量包
400	-	请求参数缺失	检查必填参数是否完整
401	-	未授权	检查AppKey或IP白名单
500	-	服务器内部错误	稍后重试，联系技术支持

注意：所有业务错误均返回200状态码，通过业务code区分。代码中应优先判断 data.code === 0。

6. 最佳实践与注意事项

6.1 缓存策略

条码对应的商品信息极少变动，建议将查询结果缓存到本地（如Redis或内存字典），设置TTL为24小时，减少重复请求。

6.2 错误重试

对于HTTP 500或超时，采用指数退避重试（最多3次）。示例（Python）：

import time

def query_with_retry(appkey, barcode, max_retries=3):
    for attempt in range(max_retries):
        result = query_barcode(appkey, barcode)
        if result and result.get("code") == 0:
            return result
        if attempt < max_retries - 1:
            time.sleep(2 ** attempt)
    return None

6.3 处理频率限制

APIZero接口默认QPS为10次/秒（具体以套餐为准）。若需批量查询大量条码，建议加入队列并控制并发数。

6.4 安全性

• AppKey 不应泄露，前端调用建议使用后端代理转发。
• 可设置IP白名单，只允许服务器IP调用。

7. 总结

通过本文，你已经掌握了商品条码查询PRO接口的完整使用方法：从在线调试到代码集成，再到错误处理与最佳实践。APIZero平台的接口文档清晰、调试方便，非常适合快速集成到电商、库存管理、物流追踪等系统中。

如果你还没有AppKey，赶紧去APIZero注册免费试用吧！

相关链接：

• APIZero 商品条码查询PRO接口
• APIZero 控制台