簡介

滴滴云圖片服務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 格式是按原圖格式保存。

總結

以上是生活随笔為你收集整理的php滴滴平台接口,图片服务API文档的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。