php滴滴平台接口,图片服务API文档

简介

滴滴云图片服务API提供标准的轻量级无状态HTTP接口，支持用户对数据的全方位管理。

接口概览API描述

图片信息获取文件的基本信息，包括长度、宽度、文件大小、格式。

图片旋转将图片按顺时针旋转。

图片模糊对图片进行模糊操作。

图片缩放将图片缩小或者放大。

图片裁剪裁剪图片，指定裁剪的起始点以及裁剪的宽高来决定裁剪的区域。

图片水印在图片上设置另外一张图片或者文字做为水印。

格式转换将图片转换成对应格式。

错误码错误码

ErrInvalidArgument                 = "InvalidArgument"

ErrBadRequest                       = "BadRequest"

ErrMissingArgument               = "MissingArgument"

ErrImageTooLarge                  = "ImageTooLarge"

ErrWatermarkError                  = "WatermarkError"

ErrAccessDenied                    = "AccessDenied"

ErrSignatureDoesNotMatch    = "SignatureDoesNotMatch"

ErrNoSuchFile                         = "NoSuchFile"

ErrNoSuchStyle                       = "NoSuchStyle"

ErrInvalidRange                       = "InvalidRange"

ErrInternalError                        = "InternalError"

ErrNotImplemented                  = "NotImplemented

图片信息(info)

功能：获取文件的基本信息，包括长度、宽度、文件大小、格式。

描述：如果文件有exif信息，则返回exif信息；如果文件没有exif信息，则只返回基本信息。返回结果是json格式。

示例

{

"FileSize": 160667,

"Format": "png",

"ImageHeight": 333,

"ImageWidth": 333

}

图片旋转(rotate)

功能：将图片按顺时针旋转。

描述：旋转图片可能会导致图片的尺寸变大；旋转对图片的尺寸有限制，图片的宽或者高不能超过 4096。操作参数描述取值范围rotatevalue图片按顺时针旋转的角度[0, 360]默认值为 0，表示不旋转。

图片模糊(blur)

功能：对图片进行模糊操作。

描述：对图片进行模糊操作。操作参数描述取值范围blurr模糊半径[1,50]r 越大图片越模糊。

s正态分布的标准差[1,50]s 越大图片越模糊。

图片缩放(resize)

功能：将图片缩小或者放大。

描述：包含原图、缩略图、其他限制条件。

原图：单边大小不能超过30,000；

缩略图：目标缩略图宽与高的乘积不能超过 4096x4096，且单边长度不能超过 4096x4。

其他限制：调用 resize，默认是不允许放大。即如果请求的图片比原图大，那么返回的仍然是原图。如果想取到放大的图片，即增加参数调用 limit_0。

当只指定宽度或者高度时，在等比缩放的情况下，都会默认进行单边的缩放。在固定宽高的模式下，会默认宽高一样的情况下进行缩略。操作名称描述取值范围按宽高缩放m指定缩略的模式：lfit： 等比缩放，限制在指定w与h的矩形内的最大图片。

mfit： 等比缩放，延伸出指定w与h的矩形框外的最小图片。

fixed：固定宽高，强制缩略。lfit、mfit、fixed，默认为 lfit。

w指定目标缩略图的宽度。1-4096

h指定目标缩略图的高度。1-4096

limit指定当目标缩略图大于原图时是否处理。值是 1 表示不处理；值是 0 表示处理。0/1, 默认是 1

按比例缩放p倍数百分比。 小于 100，即是缩小，大于 100 即是放大。1-1000

示例：

图片裁剪(crop)

功能：裁剪图片，指定裁剪的起始点以及裁剪的宽高来决定裁剪的区域。

描述：如果指定的起始横纵坐标大于原图，将会返回错误：BadRequest, 错误内容是：Advance cut’s position is out of image.

如果从起点开始指定的宽度和高度超过了原图，将会直接裁剪到原图结尾。操作名称描述取值范围裁剪w指定裁剪宽度。[0-图片宽度]

h指定裁剪高度。[0-图片高度]

x指定裁剪起点横坐标(默认左上角为原点)。[0-图片边界]

y指定裁剪起点纵坐标(默认左上角为原点)。[0-图片边界]

g设置裁剪的原点位置，由九宫格的格式，一共有九个地方可以设置，每个位置位于每个九宫格的左上角。[nw, north, ne, west, center, east, sw, south, se]

裁剪原点位置参数示意图：

图片水印(watermark)

功能：在图片上设置另外一张图片或者文字做为水印。

描述：图片水印的水印图只能使用当前S3存储空间的图片，网络图片需上传至当前存储空间方可使用。

一张图片上,最多支持3张不同的水印图做水印。

同一张水印图，可以重复使用，但是必须放在不同位置。

各个水印位置，不能完全重叠。操作名称描述取值范围基础水印参数g水印打在图的位置。[nw,north,ne,west,center,east,sw,south,se]

x参数意义：水平边距，就是距离图片边缘的水平距离， 这个参数只有当水印位置是左上，左中，左下， 右上，右中，右下才有意义。

默认值：10，单位：像素(px)[0 – 4096]

y参数意义：垂直边距, 就是距离图片边缘的垂直距离， 这个参数只有当水印位置是左上，中上， 右上，左下，中下，右下才有意义

默认值：10，单位：像素(px)[0 – 4096]

图片水印参数image水印图片为当前的Bucket下Object，直接针对Object名称进行base64编码。

内容必须是URL安全base64编码 encodedObject = url_safe_base64_encode(object) 如object为”panda.png”, 编码过后的内容为”cGFuZGEucG5n”URL安全的base64编码

文字水印参数text参数意义：表示文字水印的文字内容(必须编码)

必须是URL安全base64编码 encodeText = url_safe_base64_encode(fontText) 最大长度为64个字符(即支持汉字最多20个左右)最大长度为64个字符(即支持汉字最多20个左右)

type表示文字水印的文字类型(必须编码)

color参数意义：文字水印文字的颜色

参数的构成必须是：六个十六进制数，如：000000表示黑色。 000000每两位构成RGB颜色， FFFFFF表示的是白色

默认值：000000黑色[0X000000, 0XFFFFFF]

size参数意义：文字水印文字大小(px)

默认值：40(0，1000]

rotate文字顺时针旋转角度[0,360]

字体支持表：参数值中文意思URL安全base64编码后的值备注wqy-zenhei文泉驿正黑d3F5LXplbmhlaQ==根据RFC，可省略填充符=变为d3F5LXplbmhlaQ

wqy-microhei文泉微米黑d3F5LW1pY3JvaGVp

fangzhengshusong方正书宋ZmFuZ3poZW5nc2h1c29uZw==根据RFC，可省略填充符=变为ZmFuZ3poZW5nc2h1c29uZw

fangzhengkaiti方正楷体ZmFuZ3poZW5na2FpdGk=根据RFC，可省略填充符=变为ZmFuZ3poZW5na2FpdGk

fangzhengheiti方正黑体ZmFuZ3poZW5naGVpdGk=根据RFC，可省略填充符=变为ZmFuZ3poZW5naGVpdGk

fangzhengfangsong方正仿宋ZmFuZ3poZW5nZmFuZ3Nvbmc=根据RFC，可省略填充符=变为ZmFuZ3poZW5nZmFuZ3Nvbmc

droidsansfallbackDroidSansFallbackZHJvaWRzYW5zZmFsbGJhY2s=根据RFC，可省略填充符=变为ZHJvaWRzYW5zZmFsbGJhY2s

格式转换(format)

功能：将图片转换成对应格式。

描述：jpg、png、bmp、webp、gif、tiff。 默认不填格式，是按原图格式返回。

对于普通缩略请求，建议 format 参数放到处理参数串最后，例如：image/resize,w_100/format,jpg。

对于缩略+水印的请，建议 format 参数跟缩略参数放在一起，例如：image/reisze,w_100/format,jpg/watermark,...。

保存成 jpg 格式时，是保存成标准型的 jpg (Baseline JPEG)。操作名称描述formatjpg将原图保存成 jpg 格式。

png将原图保存成 png 格式。

webp将原图保存成 webp 格式。

bmp将原图保存成 bmp 格式。

tiff将原图保存成 tiff 格式。

gif将 gif 格式保存成 gif 格式，非 gif 格式是按原图格式保存。