头像 API (BASIC ALL)
引入于 11.0 版本。
获取一个单独的头像的 URL
通过用户的邮箱地址来获取单个头像的资源地址。
假设:
- 提供的公共邮箱地址没有找到关联的用户,则会返回外部的头像服务的结果。
- 对外的可见性是被限制的,那么在没有授权的情况下请求会返回
403 Forbidden
。
这个 API 可以在没有授权的情况下访问。
GET /avatar?email=admin@example.com
参数:
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
email
| string | yes | 该用户的公共邮箱地址。 |
size
| integer | no | 单一的像素尺寸(因为图像是一个正方形)。仅用于在 Gravatar 或配置好的 Libravatar 服务器中查询头像。 |
请求示例:
curl "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"
}