图像

生成摸摸头GIF (QQ号)

0次调用
2 积分/次

想在线rua一下好友的头像吗?这个趣味接口可以满足你。

功能概述

此接口通过GET方法,专门用于通过QQ号生成摸摸头GIF。你只需要提供一个QQ号码,我们就会自动获取其公开头像,并制作成一个可爱的动图。

使用须知

  • 响应格式:接口成功时直接返回 image/gif 格式的二进制数据。
  • 背景颜色:你可以通过 bg_color 参数来控制GIF的背景。使用 transparent 选项可以让它更好地融入各种聊天背景中。

查询参数

qq
string必填

你想要摸头的对象的QQ号码。

bg_color
string可选

GIF的背景颜色。留空则由后端服务决定默认值。

响应

200 / 请求成功

生成成功!响应体是GIF格式的图片二进制数据。

image/gif
图片响应说明
Response · Image/GIF
这是什么

接口返回的是图片的二进制数据流,而非 JSON 对象。客户端在接收到响应后,需要将其作为图片文件进行解析和处理。

前端展示方案

在浏览器环境中,最标准的做法是将响应体读取为 Blob 对象,并通过 URL.createObjectURL 生成一个临时的本地访问地址,最后将其赋值给 <img> 标签。为了避免内存泄漏,建议在图片加载完成后释放该 URL。

TYPESCRIPT
Node.js 服务端保存方案

如果是在 Node.js 环境中调用该接口,可以将响应转换为 ArrayBuffer,再转为 Buffer 并写入本地文件系统。

TYPESCRIPT

400 / 错误的请求

请求参数错误。必须提供有效的 'qq' 参数。

JSON

500 / 服务器内部错误

服务器内部错误。可能的原因包括:获取QQ头像失败,或在生成GIF过程中发生错误。

JSON