POST公开旧版图片头像GIF迁移vv1

摸摸头(旧版)

旧 Face_Petpet 完整迁移:QQ 号/图链头像裁剪成圆形后套进宠物抚摸动图,返回 GIF。

/api/Face_Petpet
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

旧 Face_Petpet 完整迁移:QQ 号/图链头像裁剪成圆形后套进宠物抚摸动图,返回 GIF。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
QQunionQQ 号(旧参数名)
qqunionQQ 的兼容小写别名
uinunionQQ 号(同 QQ,优先于 url)
urlstring头像图片链接(PNG/JPEG/GIF)
cacheunion非空且不为 0 时强制刷新缓存(旧缓存 10 分钟过期)

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "QQ": "10001"
}

返回示例

response.json
{
  "base64": "<GIF base64>",
  "contentType": "image/gif"
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →