{{< 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"
}