Back to Gitlabhq

API Avatar

doc-locale/fr-fr/api/avatar.md

19.2.01.7 KB
Original Source

{{< details >}}

  • Édition : Gratuite, GitLab Premium, GitLab Ultimate
  • Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

Utilisez cette API pour interagir avec les avatars des utilisateurs.

Récupérer l'avatar d'un compte utilisateur {#retrieve-user-account-avatar}

Récupère l'URL de l'avatar d'un compte utilisateur associé à une adresse e-mail publique spécifiée. Ce point de terminaison ne nécessite pas d'authentification.

  • En cas de succès, renvoie l'URL de l'avatar.
  • Si aucun compte n'est associé à l'adresse e-mail donnée, renvoie les résultats des services d'avatar externes.
  • Si la visibilité publique est restreinte et que la requête n'est pas authentifiée, renvoie 403 Forbidden.
plaintext
GET /[email protected]

Paramètres :

AttributTypeObligatoireDescription
emailstringouiAdresse e-mail publique du compte.
sizeentiernonDimension en pixel unique. Utilisé uniquement pour les recherches d'avatar sur Gravatar ou un serveur Libravatar configuré.

Exemple de requête :

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

Exemple de réponse :

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