# Appearance API > 原文：[https://docs.gitlab.com/ee/api/appearance.html](https://docs.gitlab.com/ee/api/appearance.html) * [Get current appearance configuration](#get-current-appearance-configuration) * [Change appearance configuration](#change-appearance-configuration) # Appearance API[](#appearance-api-core-only "Permalink") 在 GitLab 12.7 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/16647) . Appearance API 使您可以像在`/admin/appearance`使用 GitLab UI 一樣維護 GitLab 的`/admin/appearance` . 該 API 需要管理員權限. ## Get current appearance configuration[](#get-current-appearance-configuration "Permalink") 列出 GitLab 實例的當前外觀配置. ``` GET /application/appearance ``` ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/appearance" ``` 響應示例： ``` { "title": "GitLab Test Instance", "description": "gitlab-test.example.com", "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", "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 } ``` ## Change appearance configuration[](#change-appearance-configuration "Permalink") 使用 API??調用來修改 GitLab 實例外觀配置. ``` PUT /application/appearance ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `title` | string | no | 登錄/注冊頁面上的實例標題 | | `description` | string | no | 降價文字顯示在登錄/注冊頁面上 | | `logo` | mixed | no | 登錄/注冊頁面上使用的實例圖像 | | `header_logo` | mixed | no | 用于主導航欄的實例圖像 | | `favicon` | mixed | no | `.ico`或`.png`格式的實例圖標 | | `new_project_guidelines` | string | no | 新項目頁面上顯示的降價文字 | | `profile_image_guidelines` | string | no | 降價文字顯示在個人頭像下方的個人資料頁面上 | | `header_message` | string | no | 系統標題欄中的消息 | | `footer_message` | string | no | 系統頁腳欄中的消息 | | `message_background_color` | string | no | 系統頁眉/頁腳欄的背景顏色 | | `message_font_color` | string | no | 系統頁眉/頁腳欄的字體顏色 | | `email_header_and_footer_enabled` | boolean | no | 如果啟用，則在所有外發電子郵件中添加頁眉和頁腳 | ``` curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "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", "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", "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 } ```