素材服务

ContentBoot会把素材发布到指定域名上。

获取数据

理论上,我们不会通过几个参数拼成一个素材的URL,然后访问。而是通过JSON数据或GraphQL API服务来获取素材URL。

素材URL的格式为: {协议}://{域名}/{文件夹路径}/{名称}.{哈希值}.{扩展名}

请参考单文件选择多文件选择

图片处理API

ContentBoot提供了基本的图片处理API。使用方式为{素材URL}?{处理参数}

缩放

图片缩放支持处理JPG、PNG、GIF、BMP、WebP格式。

处理参数

接口名称:imageMogr2

参数描述
/thumbnail/!<Scale>p指定图片的宽高为原图的Scale%
/thumbnail/!<Scale>px指定图片的宽为原图的Scale%,高度不变
/thumbnail/!x<Scale>p指定图片的高为原图的Scale%,宽度不变
/thumbnail/<Width>x指定目标图片宽度为Width,高度等比缩放
/thumbnail/x<Height>指定目标图片高度为Height,宽度等比缩放
/thumbnail/<Width>x<Height>限定缩略图的宽度和高度的最大值分别为Width和Height,进行等比缩放
/thumbnail/<Width>x<Height>>限定缩略图的宽度和高度的最大值分别为Width和Height,进行等比缩小,比例值为宽缩放比和高缩放比的较小值,如果目标宽(高)都大于原图宽(高),则不变
/thumbnail/<Width>x<Height><限定缩略图的宽度和高度的最大值分别为Width和Height,进行等比放大,比例值为宽缩放比和高缩放比的较小值。如果目标宽(高)小于原图宽(高),则不变
/thumbnail/!<Width>x<Height>r限定缩略图的宽度和高度的最小值分别为Width和Height,进行等比缩放
/thumbnail/<Width>x<Height>!忽略原图宽高比例,指定图片宽度为Width,高度为Height,强行缩放图片,可能导致目标图片变形
/thumbnail/<Area>@等比缩放图片,缩放后的图像,总像素数量不超过Area
/pad/将原图缩放为指定Width和Height的矩形内的最大图片,之后使用color参数指定的颜色居中填充空白部分;取值0或1,0代表不使用pad模式,1代表使用pad模式
/color/填充颜色,缺省为白色,需设置为十六进制RGB格式(如#FF0000),详情参考RGB编码表,需经过URL安全的Base64编码,默认值为#FFFFFF
/ignore-error/1当处理参数中携带此参数时,针对文件过大导致处理失败的场景,会直接返回原图而不报错

示例

假设缩放图片宽高为原图50%,示例如下:

{素材URL}?imageMogr2/thumbnail/!50p

假设缩放指定图片宽度为原图50%,高度不变,示例如下:

{素材URL}?imageMogr2/thumbnail/!50px

将原图缩放为600x600的矩形内的最大图片,并使用指定颜色填充空白部分,示例如下:

{素材URL}?imageMogr2/thumbnail/600x600/pad/1/color/IzNEM0QzRA
上次更新: