智能多媒体 API

  • 图片基本信息

    最近更新时间:2017-11-13 10:16:18

    图片基本信息包括图片格式、图片大小、色彩模型。
    在图片下载URL后附加imageInfo指示符(区分大小写),即可获取JSON格式的图片基本信息。

    请求报文

    请求语法

    GET <imageDownloadUri>?imageInfo HTTP/1.1
    Host: <imageDownloadHost>
    

    头部信息

    头部名称 必填 说明
    Host 下载服务器域名,可为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程

    响应报文

    响应语法

    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    
    {
        "size":         "<ImageSize         int>",
        "format":       "<ImageType         string>",
        "width":         <ImageWidth        int>,
        "height":        <ImageHeight       int>,
        "colorModel":   "<ImageColorModel   string>",
        "frameNumber":   <ImageFrameNumber  int>
    }
    

    头部信息

    头部名称 必填 说明
    Content-Type MIME类型,固定为application/json
    Cache-Control 缓存控制,固定为no-store,不缓存。

    响应内容

    • 如果请求成功,返回包含如右内容的JSON字符串(已格式化,便于阅读):
    {
        "size":         "<ImageSize         int>",
        "format":       "<ImageType         string>",
        "width":         <ImageWidth        int>,
        "height":        <ImageHeight       int>,
        "colorModel":   "<ImageColorModel   string>",
        "frameNumber":   <ImageFrameNumber  int>
    }
    
    字段名称 必填 说明
    size 文件大小,单位:Bytes
    format 图片类型,如pngjpeggifbmp等。
    width 图片宽度,单位:像素(px)。
    height 图片高度,单位:像素(px)。
    colorModel 彩色空间,如palette16ycbcr等。
    frameNumber 帧数,gif 图片会返回此项。
    • 如果请求失败,返回包含如右内容的JSON字符串(已格式化,便于阅读):
    {
        "code":     <HttpCode  int>, 
        "error":   "<ErrMsg    string>",
    }
    
    字段名称 必填 说明
    code HTTP状态码,请参考响应状态码
    error 与HTTP状态码对应的消息文本

    响应状态码

    HTTP状态码 含义
    200 下载成功
    400 请求报文格式错误
    404 资源不存在
    599 服务端操作失败。

    如遇此错误,请将完整错误信息(包括所有HTTP响应头部)[通过邮件发送][sendBugReportHref]给我们。

    示例

    在Web浏览器中输入以下图片地址:

    http://78re52.com1.z0.glb.clouddn.com/resource/gogopher.jpg?imageInfo
    

    返回结果(内容经过格式化以便阅读):

    {
        "size":         79652,
        "format":       "jpeg",
        "width":        640,
        "height":       427,
        "colorModel":   "ycbcr"
    }
    
    以上内容是否对您有帮助?
  • 提交工单