# Avatar API

> 原文：[https://docs.gitlab.com/ee/api/avatar.html](https://docs.gitlab.com/ee/api/avatar.html)

*   [Get a single avatar URL](#get-a-single-avatar-url)

# Avatar API[](#avatar-api "Permalink")

在 GitLab 11.0 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/19121) .

## Get a single avatar URL[](#get-a-single-avatar-url "Permalink")

使用给定的电子邮件地址为用户获取一个[头像](../user/profile/index.html#profile-settings) URL.

If:

*   找不到具有给定公共电子邮件地址的用户，返回来自外部化身服务的结果.
*   公开可见性受到限制，未经身份验证时，响应将为`403 Forbidden` .

**注意：**无需身份验证即可访问此端点.

```
GET /avatar?email=admin@example.com 
```

Parameters:

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| `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"  } 
```