通用条形码生成

按所选条码类型的字符与校验位规则提交内容。type 保留现有大小写与下划线别名；不支持的类型明确失败。图片目标尺寸与文字标签按现有引擎处理，扫码可读性还受尺寸和条码密度影响。cdn 为历史存储参数，不改变条码内容；正式结果仅在真实 PNG 及上传成功后返回。
按指定条码类型生成 PNG 图片，便于制作业务标签。
支持经过样例验证的 UPC-A 数字条码。
支持经过样例验证的 EAN-13 数字条码。
支持经过样例验证的 Code 128 条码。
使用 width 指定生成图片的目标宽度。
使用 height 指定生成图片的目标高度。
可通过 showLabel 选择是否显示条码文字标签。
返回可下载的图片地址，便于在网页和管理后台引用。
返回条码类型与原始内容，便于核对标签对应关系。
可用于商品资料中已有条码的图片展示。
可为库存、资产或业务凭证生成可扫描标签。

当前接口契约

接口详情：https://www.gugudata.com/api/details/barcode

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	付费后获取的 APPKEY AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
type	string	是	无	条码类型，可选项: UPCA\|UPCE\|UPC_SUPPLEMENTAL_2DIGIT\|UPC_SUPPLEMENTAL_5DIGIT\|EAN13\|EAN8\|Interleaved2of5\|Interleaved2of5_Mod10\|Standard2of5\|Standard2of5_Mod10\|Industrial2of5\|Industrial2of5_Mod10\|CODE39\|CODE39Extended\|CODE39_Mod43\|Codabar\|PostNet\|BOOKLAND\|ISBN\|JAN13\|MSI_Mod10\|MSI_2Mod10\|MSI_Mod11\|MSI_Mod11_Mod10\|Modified_Plessey\|CODE11\|USD8\|UCC12\|UCC13\|LOGMARS\|CODE128\|CODE128A\|CODE128B\|CODE128C\|ITF14\|CODE93\|TELEPEN\|FIM\|PHARMACODE
content	string	是	无	条码内容，注意对应条码的长度规范
width	integer	是	无	条码宽度像素值
height	integer	是	无	条码高度像素值
showLabel	boolean	否	false	控制是否显示条码底部的文字标签，默认不显示，需要显示传递 true
cdn	string	否	无	兼容历史存储选择；不改变条码内容。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	真实可读的业务参数，不包含凭据。
DataStatus.StatusCode	integer	成功 100；参数和依赖错误按下列错误说明判断。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	接口响应时间。
DataStatus.DataTotalCount	integer	成功结果为一个条码对象，值为 1。
Data	object	条码结果对象。
Data.Content	string	类型:内容，保留实际输入。
Data.Url	string	已验证并上传成功的 PNG 图片下载地址。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
901	处理、依赖失败或超时	HTTP 503
502	请求频率限制	HTTP 429
503	权益过期	HTTP 403
504	凭据缺失或无效、无商品权限、鉴权服务不可用；结合状态判断	HTTP 401/403/503
505	调用额度不足	HTTP 403

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "{\"type\":\"UPCA\",\"content\":\"065258744748\",\"width\":290,\"height\":120,\"showLabel\":false,\"cdn\":\"\"}",
    "StatusCode": 100,
    "StatusDescription": "生成成功",
    "ResponseDateTime": "2026-10-26 11:06:51.251",
    "DataTotalCount": 1
  },
  "Data": {
    "Content": "UPCA:065258744748",
    "Url": "https://static.gugudata.com/barcode/barcode_bd407d9572144e588f33200a0c9a8fff.png"
  }
}

🟠400参数错误（业务码 501）。

🔴503处理、依赖失败或超时（业务码 901）；凭据缺失或无效、无商品权限、鉴权服务不可用；结合状态判断（业务码 504）。

🟠401凭据缺失或无效、无商品权限、鉴权服务不可用；结合状态判断（业务码 504）。

🟠403权益过期（业务码 503）；凭据缺失或无效、无商品权限、鉴权服务不可用；结合状态判断（业务码 504）；调用额度不足（业务码 505）。

🟠429请求频率限制（业务码 502）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明