v3/photo/get_pic

调用本接口前,请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。

目录

1 功能说明

1. 接口功能:获取用户在应用中上传过的图片的url。

2. 功能描述:
(1)为支持某些应用调用互动性接口时,希望使用个性化图片的需求(例如应用在调用分享接口时,希望不同用户使用不同的图片),特别提供图片存储接口v3/photo/save_pic
(2)应用将指定的图片上传后,通过调用本接口来获取用户在应用中上传过的图片的url。

3. 接口调用限制:
本接口仅提供给hosting应用使用。

2 接口调用说明

2.1 URL

http://[域名]/v3/photo/get_pic

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
pic_size string 需要获取的图片尺寸。

0:返回原图;
500:返回长边为500px的图片;
316:返回长边为316px的图片。
如果不传该参数,则默认为0,即返回原图。
说明
图片上传后,平台会对图片进行处理,分别存储以下尺寸的图片:
(1)原图:不对图片进行处理,保持原图的尺寸;
(2)长边为500px的图片:将图片的较长的边压缩为500px,较短的边按比例进行压缩;
(3)长边为316px的图片:将图片的较长的边压缩为316px,较短的边按比例进行压缩。

file_ids string 指定获取的图片的ID,多个ID之间以下划线“_”分隔。最多可传100个ID。

如果不传该参数, 默认返回用户在该应用里面上传过的全部图片。

2.6 请求示例

http://openapi.tencentyun.com/v3/photo/get_pic?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
pf=qzone&
format=json&
userip=112.90.139.30&
pic_size=500&
file_ids=89cd307e4a94bc2b6873ba456473b1f8_d66cb73e09f76ea6e01238010c8a225d&
sig=9999b41ad0b688530bb1b21c5957391c


2.7 返回参数说明

参数名称 描述
ret 返回码。

私有返回码如下:
2001:要获取的头像不存在。
公共返回码详见:公共返回码说明#OpenAPI V3.0 返回码

msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

file_id 获取到的图片对应的唯一ID。
url 获取到的图片url。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
  "ret":0,   
  "is_lost":0, 
  "items": [   
      {
        "file_id": "d66cb73e09f76ea6e01238010c8a225d",
        "url":"http://p.qpic.cn/open3rd/10883/5BA61AE/500"
      },
      {
        "file_id": "89cd307e4a94bc2b6873ba456473b1f8",
        "url":"http://p.qpic.cn/open3rd/10883/5BA62AE/500"
      }
} 

2.9 错误返回示例

Content-type: text/html; charset=utf-8
{
  "ret":1002,
  "msg":"请先登录" 
}

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部