正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

アバターAPI

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

このAPIを使用して、ユーザーのアバターを操作します。

ユーザーアカウントのアバターを取得する

指定された公開メールアドレスに関連付けられたユーザーアカウントのアバターのURLを取得するします。このエンドポイントでは認証は不要です。

  • 成功した場合、アバターのURLを返します。
  • 指定されたメールアドレスに関連付けられたアカウントがない場合、外部のアバターサービスからの結果を返します。
  • 公開表示レベルが制限されており、リクエストが認証されていない場合、403 Forbiddenを返します。
GET /avatar?email=admin@example.com

パラメータは以下のとおりです:

属性必須説明
email文字列はいアカウントの公開メールアドレス。
size整数いいえ単一のピクセル寸法。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"
}