极狐 GitLab Logo

头像 API

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: JihuLab.com, 私有化部署

使用此 API 与用户头像互动。

获取账户头像详情#

获取与给定公共电子邮件地址关联的账户 头像 的 URL。此端点不需要认证。

  • 如果成功，返回头像的 URL。
  • 如果没有账户与给定的电子邮件地址关联，则从外部头像服务返回结果。
  • 如果公共可见性受到限制且请求未认证，则返回 403 Forbidden。
plaintext
GET /avatar?email=admin@example.com

参数：

属性类型必需描述
emailstringyes账户的公共电子邮件地址。
sizeintegerno单个像素尺寸。仅用于在 Gravatar 或配置的 Libravatar 服务器上的头像查找。

示例请求：

shell
curl --request GET \
  --url "https://gitlab.example.com/api/v4/avatar?email=admin@example.com&size=32"

示例响应：

json
{
  "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=64&d=identicon"
}