{{< details >}}

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

{{< /details >}}

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

获取账户头像详情

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

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

参数:

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

示例请求:

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

示例响应:

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