# Barcode APIs
提供条形码、二维码的图像数据生成,此API接口无需授权,可作为IMG元素的src。
# 二维码
- GET https://api.sjtu.edu.cn/v1/barcode/qr/{fileName}.{imageType}
# 请求参数
# 路径参数
参数名 | 描述 |
---|---|
fileName | 图像文件名称,允许任意值,对产生的二维码图像数据无意义 |
imageType | 图像文件类型,允许值包括gif、jpg、jpeg、png |
# 查询参数
参数名 | 类型 | 描述 |
---|---|---|
value | string | 二维码所代表的内容 |
size | int | 二维码的大小。合法取值为1 - 10,默认为3,表示产生的二维码长和宽均为size * 21像素。 |
ecclevel | int | 容错率。合法取值为0 - 3,默认为0,表示产生的二维码容错率从低到高的4个层次 |
# 响应
响应为图片二进制流
# 请求示例
GET /v1/barcode/qr/1.png?value=123456&size=8&ecclevel=0 HTTP/1.1
Host: api.sjtu.edu.cn
1
2
2
# 响应示例
示例 二维码响应
# 条形码
- GET https://api.sjtu.edu.cn/v1/barcode/{type}/{value}.{imageType}
# 请求参数
# 路径参数
参数名 | 描述 |
---|---|
type | 条形码类型,允许值为c39、ean13 |
value | 条形码所代表的内容,允许取值应按照条形码类型而定 |
imageType | 图像文件类型,允许值包括gif、jpg、jpeg、png |
# 查询参数
参数名 | 类型 | 描述 |
---|---|---|
width | int | 条形码宽度像素值,默认为250 |
height | int | 条形码高度像素值,默认为100 |
isTextDrawn | boolean | 是否显示文字内容,默认是false |
textSize | int | 文字大小, 默认为5 |
# 响应
响应为图片二进制流
# 请求示例
GET /v1/barcode/ean13/6937455310672.png?isTextDrawn=1&width=300 HTTP/1.1
Host: api.sjtu.edu.cn
1
2
2
# 响应示例
示例 条形码响应