アバターAPI
GitLab 11.0で導入されました。
単一のアバターURLを取得
指定したメールアドレスのユーザーのアバターURL を取得します。
If:
- 指定された公開メールアドレスを持つユーザーが見つからない場合は、外部のアバターサービスからの結果が返されます。
- 公開は制限されており、認証されていない場合のレスポンスは
403 Forbidden
です。
このエンドポイントは認証なしでアクセスできます。
GET /avatar?email=admin@example.com
パラメータを指定します:
属性 | 種類 | 必須 | 説明 |
---|---|---|---|
email | 文字列です。 | yes | ユーザーの公開メールアドレス。 |
size | 整数。 | いいえ | 単一ピクセル寸法(画像は正方形であるため)。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"
}