Help us learn about your current experience with the documentation. Take the survey.

头像 API

  • 版本:Free, Premium, Ultimate
  • 产品:GitLab.com, GitLab Self-Managed, GitLab Dedicated

使用此 API 来操作用户头像。

获取账户头像的详细信息

获取与指定公开电子邮件地址关联的账户头像的 URL。此端点不需要身份验证。

  • 如果成功,则返回头像的 URL。
  • 如果没有账户与给定的电子邮件地址关联,则返回外部头像服务的结果。
  • 如果公开可见性受到限制且请求未经过身份验证,则返回 403 Forbidden

参数:

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

示例请求:

curl --request GET \
  --url "https://gitlab.example.com/api/v4/[email protected]&size=32"

示例响应:

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