图像

获取Gravatar头像

0次调用
2 积分/次

提供稳定、易用的头像获取能力,适合在网页或应用中直接展示头像。

查询参数

email
string可选

用户的 Email 地址。如果未提供 hash 参数,则此参数为必需。

hash
string可选

用户 Email 地址的小写 MD5 哈希值。如果提供此参数,将忽略 email 参数。

s
integer可选

头像的尺寸,单位为像素。有效范围是 1 到 2048。

d
string可选

当用户没有自己的 Gravatar 头像时,显示的默认头像类型。可选值包括 mp, identicon, monsterid, wavatar, retro, robohash, blank, 404

r
string可选

头像分级。可选值:g, pg, r, x

响应

200 / 请求成功

成功响应,返回图片二进制数据。

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

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

前端展示方案

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

TYPESCRIPT
Node.js 服务端保存方案

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

TYPESCRIPT

400 / 错误的请求

当请求中既没有提供 email 也没有提供 hash 参数时。

JSON

404 / 未找到

d=404 且请求的 email 或 hash 没有对应的 Gravatar 头像时。

JSON