蓝钻接入API列表
5.8 /v3/user/get_figure
返回指定当前用户的自定义头像
5.8.1 URL
//[域名/IP]/v3/user/get_figure
5.8.2 格式
JSON
5.8.3 HTTP请求方式
GET,POST
5.8.4 IP限制
TRUE
5.8.5 输入参数说明
| 参数 | 类型 | 含义 | 可选/必选 |
|---|---|---|---|
| appid | int | 详见公共参数说明部分 | 必选 |
| openid | string | 详见公共参数说明部分 | 必选 |
| openkey | string | 详见公共参数说明部分 | 必选 |
| flag | string | 自定义头像分辨率的标识 1: 40*40 2: 100*100 3: 140*140 4: 原始头像(只针对QQ会员提供) |
必选 |
| sig | int | 详见公共参数说明部分 | 必选 |
| pf | string | 详见公共参数说明部分 | 必选 |
| seq | int | 回传字段 | 可选 |
5.8.6 请求事例
//113.108.20.23/user/get_figure?
openid=0000000000000000000000000079F53D&
openkey=BC78A8A0DF9CDEC0D5D96174831FF3CB&
appid=29137&pf=qqgame&flag=1&
sig=LwspGv3t7kJewXdWXqLWOg5cu4s%3D
openid=0000000000000000000000000079F53D&
openkey=BC78A8A0DF9CDEC0D5D96174831FF3CB&
appid=29137&pf=qqgame&flag=1&
sig=LwspGv3t7kJewXdWXqLWOg5cu4s%3D
返回参数说明
| 参数 | 类型 | 含义 |
|---|---|---|
| ret | int | 详见公共返回码 |
| msg | string | 错误描述 |
| seq | int | 回传字段 |
| id | string | 当前用户的openid |
| figure_url | string | 自定义头像url |
5.8.7 正确返回示例
{"ret":0,
"msg":"操作成 功！",
"uin":0,
"id":"0000000000000000000000000079F53D",
"figure_url":"//q2.qlogo.cn/g?b=qq&k=IX6fOibMoPjoO99x8TD9C8Q&s=40&t=13542596"}
"msg":"操作成 功！",
"uin":0,
"id":"0000000000000000000000000079F53D",
"figure_url":"//q2.qlogo.cn/g?b=qq&k=IX6fOibMoPjoO99x8TD9C8Q&s=40&t=13542596"}
5.8.8 错误返回示例
参见公共错误返回示例