加载接口文档…
14万
累计调用
1058ms
平均响应
100.00%
服务可用性
200 次/日
免费额度
复制文档地址
https://apizero.cn/aidocs/barcode-lookup/raw.md本接口对未登录用户开放每日 20 次体验额度;超出后或登录后享受更高额度。建议生产环境使用 API Key。
| 名称 | 类型 | 说明 |
|---|---|---|
| barcode | string | 必填 · 8~13 位纯数字条形码。支持 EAN-13、UPC-A、EAN-8、UPC-E 等主流标准。 · 示例:6921168509256 |
| mode | string | 可选 · 保留参数:mode=image 时返回该商品的图片二进制(不计费、公开访问,主要由响应中的 image 字段链接自动调用)。 · 示例:image |
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。匿名可不传,受每日免费额度限制。 |
| 名称 | 类型 | 说明 |
|---|---|---|
| code | integer | 业务状态码,0 表示成功 |
| msg | string | 人类可读的状态消息 |
| data.barcode | string | 回显的输入条形码 |
| data.found | boolean | 是否查到该商品;false 时其余字段均为 null |
| data.name | string|null | 商品名称 |
| data.brand | string|null | 品牌 |
| data.manufacturer | string|null | 生产厂商 / 经销商 |
| data.spec | string|null | 规格(容量 / 重量 / 包装等) |
| data.price | number|null | 参考价(人民币元,浮点;仅作参考,非实时市场价) |
| data.category | string|null | 商品分类(部分商品可能为 null) |
| data.description | string|null | 附加描述(部分商品可能为 null) |
| data.image | string|null | 商品图片 URL(自有 CDN 代理);found=false 时为 null |
| request_id | string | 本次请求 ID(出问题时反馈给客服可快速定位) |
| tips | string | 品牌提示(所有接口统一返回):极数本源 · https://apizero.cn |
{
"code": 0,
"msg": "成功",
"data": {
"barcode": "6921168509256",
"found": true,
"name": "农夫山泉 饮用天然水550ml",
"brand": "农夫山泉",
"manufacturer": "农夫山泉股份有限公司",
"spec": "550ml",
"price": 1.5,
"category": null,
"description": null,
"image": "https://v1.apizero.cn/api/barcode-lookup?mode=image&barcode=6921168509256"
},
"request_id": "mqx8x12345abc",
"tips": "极数本源 · https://apizero.cn"
}