素材服务
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