アプリケーション外観API

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

このAPIを使用して、GitLabインスタンスの外観を制御します。詳細については、GitLabの表示設定を参照してください。

前提条件:

インスタンスへの管理者アクセス権が必要です。

アプリケーションの表示設定を取得する

このGitLabインスタンスの表示設定を取得します。

GET /application/appearance

リクエスト例:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/application/appearance"

レスポンス例:

{
  "title": "GitLab Test Instance",
  "description": "gitlab-test.example.com",
  "pwa_name": "GitLab PWA",
  "pwa_short_name": "GitLab",
  "pwa_description": "GitLab as PWA",
  "pwa_icon": "/uploads/-/system/appearance/pwa_icon/1/pwa_logo.png",
  "logo": "/uploads/-/system/appearance/logo/1/logo.png",
  "header_logo": "/uploads/-/system/appearance/header_logo/1/header.png",
  "favicon": "/uploads/-/system/appearance/favicon/1/favicon.png",
  "member_guidelines": "Custom member guidelines",
  "new_project_guidelines": "Please read the FAQs for help.",
  "profile_image_guidelines": "Custom profile image guidelines",
  "header_message": "",
  "footer_message": "",
  "message_background_color": "#e75e40",
  "message_font_color": "#ffffff",
  "email_header_and_footer_enabled": false,
  "site_name": "Production"
}

アプリケーションの表示設定を更新する

このGitLabインスタンスの表示設定を更新します。

PUT /application/appearance

属性	型	必須	説明
`title`	文字列	いいえ	サインイン/サインアップページでのインスタンスのタイトル
`description`	文字列	いいえ	サインイン/サインアップページに表示されるMarkdownテキスト
`pwa_name`	文字列	いいえ	プログレッシブウェブアプリの正式名称。`manifest.json`の属性`name`に使用されます。GitLab 15.8で導入されました。
`pwa_short_name`	文字列	いいえ	プログレッシブウェブアプリの短い名前。GitLab 15.8で導入されました。
`pwa_description`	文字列	いいえ	プログレッシブウェブアプリの機能の説明。`manifest.json`の属性`description`に使用されます。GitLab 15.8で導入されました。
`pwa_icon`	混合	いいえ	プログレッシブウェブアプリに使用されるアイコン。アプリケーションロゴの更新を参照してください。GitLab 15.8で導入されました。
`logo`	混合	いいえ	サインイン/サインアップページで使用されるインスタンスの画像。アプリケーションロゴの更新を参照してください。
`header_logo`	混合	いいえ	メインナビゲーションバーで使用されるインスタンスの画像
`favicon`	混合	いいえ	インスタンスのファビコン（`.ico`または`.png`形式）
`member_guidelines`	文字列	いいえ	メンバーを変更する権限を持つユーザー向けに、グループまたはプロジェクトのメンバーページに表示されるMarkdownテキスト
`new_project_guidelines`	文字列	いいえ	新規プロジェクトページに表示されるMarkdownテキスト
`profile_image_guidelines`	文字列	いいえ	公開アバターの下のプロフィールページに表示されるMarkdownテキスト
`header_message`	文字列	いいえ	システムヘッダーバーのメッセージ
`footer_message`	文字列	いいえ	システムフッターバーのメッセージ
`message_background_color`	文字列	いいえ	システムヘッダー/フッターバーの背景色
`message_font_color`	文字列	いいえ	システムヘッダー/フッターバーのフォントの色
`email_header_and_footer_enabled`	ブール値	いいえ	有効な場合、すべての送信メールにヘッダーとフッターを追加
`site_name`	文字列	いいえ	ページタイトル後にサイト名を追加します。

リクエスト例:

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/application/appearance?email_header_and_footer_enabled=true&header_message=test"

レスポンス例:

{
  "title": "GitLab Test Instance",
  "description": "gitlab-test.example.com",
  "pwa_name": "GitLab PWA",
  "pwa_short_name": "GitLab",
  "pwa_description": "GitLab as PWA",
  "pwa_icon": "/uploads/-/system/appearance/pwa_icon/1/pwa_logo.png",
  "logo": "/uploads/-/system/appearance/logo/1/logo.png",
  "header_logo": "/uploads/-/system/appearance/header_logo/1/header.png",
  "favicon": "/uploads/-/system/appearance/favicon/1/favicon.png",
  "member_guidelines": "Custom member guidelines",
  "new_project_guidelines": "Please read the FAQs for help.",
  "profile_image_guidelines": "Custom profile image guidelines",
  "header_message": "test",
  "footer_message": "",
  "message_background_color": "#e75e40",
  "message_font_color": "#ffffff",
  "email_header_and_footer_enabled": true,
  "site_name": ""
}

アプリケーションロゴの更新

含まれている画像ファイルを使用して、このGitLabインスタンスのロゴを更新します。

ローカルファイルシステムからアバターをアップロードするには、ファイルを指定するために--form引数を使用します。これにより、cURLはヘッダーContent-Type: multipart/form-dataを使用してデータを送信します。file=パラメータは、ファイルシステムの画像ファイルを指しており、先頭に@を付ける必要があります。

PUT /application/appearance

属性	型	必須	説明
`logo`	混合	はい	ロゴとして使用される画像。
`pwa_icon`	混合	はい	プログレッシブウェブアプリに使用される画像。GitLab 15.8で導入されました。

リクエスト例:

curl --location --request PUT \
  --url "https://gitlab.example.com/api/v4/application/appearance?data=image/png" \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-Type: multipart/form-data" \
  --form "logo=@/path/to/logo.png"

レスポンス例:

{
  "logo":"/uploads/-/system/appearance/logo/1/logo.png"
}