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。
GET /avatar?email=admin@example.com参数:
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
email |
string | 是 | 账户的公开电子邮件地址。 |
size |
integer | 否 | 单个像素尺寸。仅用于在 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"
}