Получение настроек кастомизации

Метод используется для получения настроек кастомизации Панели управления Клиента (см. ).

GET {reseller_domain}/internal_api/customization_setting

В этой статье:

Авторизация

Авторизация не требуется.

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

Content-Type

header

string

Обязательный

Тип данных, передаваемых в запросе. Укажите application/vnd.api+json

Accept

header

string

Обязательный

Поддерживаемые типы данных в ответе. Укажите application/vnd.api+json

X-Api-Locale

header

string

Опциональный

Двухбуквенный код языка данных в ответе

reseller_domain

path

string

Обязательный

Доменное имя реселлера

Модель ответа

Название

Тип данных

Описание

data

object

Данные ответа


id

string

ID настроек кастомизации


type

string

Тип данных


attributes

object

Информация о настройках кастомизации



global_settings

object

Настройки кастомизации из раздела Общие настройкиНастройки оформления (см.


)




title

string

Заголовок сайта




background_image

string

Фоновый рисунок 




show_copyright

bool

Признак Отображать копирайт




primary_color

string

Акцентный цвет




header

object

Группа настроек Header





sections

array

Список разделов, которые должны отображаться в навигационном меню:

  • main Главная.

  • orders Заказы.

  • quotesЗапросы цен.

  • billing Биллинг.

  • catalog Каталог услуг.

  • payments Платежи.

  • analytics Аналитика.

  • subscriptions Подписки.

  • balance_statement История баланса.

  • closing_documents Закрывающие документы.

  • guaranteed_payments Обещанные платежи.





navigation_menu_display

string

Настройка Положение навигационного меню (не поддерживается в текущей версии Панели управления Клиента):

  • inline — горизонтальное, вверху страниц.

  • vertical — вертикальное, слева в раскрывающемся меню.





content

object

Настройки содержимого






links

array of objects

Список ссылок, которые должны отображаться в хедере страниц Панели управления Клиента







url

string

URL ссылки







name

string

Текст ссылки на выбранном языке







priority

integer

Приоритет — число, которое определяет порядок отображения ссылок в виджете. Чем больше число, тем выше отображается ссылка в списке




footer

object

Группа настроек Footer





content

object

Настройки содержимого






links

array of objects

Список ссылок, которые должны отображаться в футере страниц Панели управления Клиента.

Если включено использование сервиса Cookiebot CMP (см. use_cookiebot_cpm_service), в списке присутсвует ссылка на страницу Cookie Policy







url

string

URL ссылки







name

string

Текст ссылки на выбранном языке







priority

integer

Приоритет — число, которое определяет порядок отображения ссылок в виджете. Чем больше число, тем выше отображается ссылка в списке





contacts

object

Контактная информация реселлера






address

string

Адрес






email

string

Email






phone

string

Номер телефона





copyright

string

Текст копирайта





socials

object

Информация о социальных сетях  реселлера






facebook

string

Ссылка на facebook






instagram

string

Ссылка на instagram






linkedin

string

Ссылка на linkedin






youtube

string

Ссылка на youtube



logo_settings

object

URL файлов логотипов (см.


)




main_logotype_ccp

string

URL основного логотипа (для панели клиента)




inverted_logo

string

URL инвертированного логотипа (для панели оператора)




short_logo

string

URL короткого логотипа (для страниц регистрации и авторизации)




mobile_logo

string

URL логотипа мобильной версии (для панели клиента)




stamp

string

URL печати реселлера для печатных форм актов




favicon

string

URL иконки, которая отображается на вкладке браузера при открытии страницы Панели управления Оператора или Панели управления Клиента



pages

object

Настройки кастомизации из разделов (см. ):

  • Страница Входа.

  • Страница Регистрации.

  • Раздел Биллинг.

  • Главная страница.

  • Страница Помощь.




signin

object

Группа настроек опционального текста приветствия, который может отображаться на странице входа Панели управления Клиента





content

object

Настройки содержимого






welcome_text

string

Приветственный текст на выбранном языке




signup

object

Группа настроек опционального текста приветствия, который может отображаться на странице регистрации Панели управления Клиента





content

object

Настройки содержимого






welcome_text

string

Приветственный текст на выбранном языке




billing

object

Группа настроек раздела Биллинг

Панели управления Клиента





widgets

array

Список виджетов, которые должны отображаться в разделе Биллинг:

  • balance Состояние баланса.

  • current_consumption Текущее потребление.

  • expected_amount_payments Предварительная сумма платежей в следующем месяце.




main

object

Группа настроек раздела Главная страница

Панели управления Клиента





content

object

Настройки содержимого






widgets

array

Список виджетов, которые должны отображаться на главной странице Панели управления Клиента:

  • balance Состояние баланса.

  • subscriptions_payments_filtersФильтры по подпискам и платежам (Подписки и платежи).

  • catalog Каталог.

  • currency_rate Курсы валют.

  • expenses Потребление.

  • help Полезное.

  • current_consumption Текущее потребление.

  • recommendations Дополнительные сервисы и продукты.

  • stories Что нового. Присутствует, если отображение виджета включено в настройках и есть хотя бы одна опубликованная сторис.






info_messages

array of objects

Группа настроек раздела Настройки информационных сообщений — список сообщений, которые должны отображаться всем клиентам на главной странице Панели управления Клиента







from

string

Дата начала периода отображения (ГГГГ-ММ-ДД)







to

string

Дата окончания периода отображения (ГГГГ-ММ-ДД)







created_at

string

Дата и время создания сообщения







importance

string

Приоритет отображения:

  • high — высокий.

  • low — низкий.







text

string

Текст сообщения на выбранном языке






widget_help

array of objects

Группа настроек раздела Настройки виджета Полезное — список ссылок, которые должны отображаться в виджете Полезное







url

string

URL ссылки







name

string

Текст ссылки на выбранном языке







priority

integer

Приоритет — число, которое определяет порядок отображения ссылок в виджете. Чем больше число, тем выше отображается ссылка в списке




support

object

Группа настроек раздела Страница Помощь — содержимое, которое может отображаться на странице Помощь в Панели управления Клиента





redirect_url

string

URL внешней страницы, если требуется, чтобы она отображалась вместо внутренней страницы Помощь





content

object

Настройки содержимого внутренней страницы Помощь






introduction_text

string

Вводный текст страницы






sections

array of objects

Группа настроек Настройка контентных блоков страницы — список карточек, которые могут отображаться на внутренней странице Помощь







title

string

Заголовок — название карточки на выбранном языке







text

string

Текст в карточке на выбранном языке







image

string

Изображение в карточке







priority

integer

Приоритет — число, которое определяет порядок отображения карточек. Чем больше число, тем выше отображается карточка в списке






feedback_section

string

Текст в блоке Обратная связь, который может отображаться на внутренней странице Помощь



custom_layout

object

Настройки кастомизации из раздела Общие настройкиДополнительные настройки (см.


)




<Component_Key>

object

Группа настроек Дополнительные настройки — список ключей отдельных элементов на страницах Панели управления Клиента для управления их отображением и названиями. Эти настройки также переопределяют настройки группы Header. Если в ответе отсутствует ключ элемента, для него дополнительные настройки не заданы:

  • buy_subscription_cmp — кнопка Купить подписку.

  • change_language_cmp — кнопка Смена языка.

  • analytics_tab — раздел Аналитика.

  • billing_tab — раздел Биллинг.

  • main_tab — раздел Главная.

  • catalog_tab — раздел Каталог услуг.

  • subscriptions_tab — раздел Подписки.





visible

bool

Признак Отображать на странице





name

string

Настраиваемое название элемента на выбранном языке



external_services

object

Группа настроек Подключение сторонних плагинов — список сервисов для подключения к Панели управления Клиента





captcha_settings

object

Группа настроек Google reCAPTCHA v2






use_captcha_service

bool

Признак Использовать сервис






site_key

string

Ключ сайта, который будет автоматически вставлен в HTML-код страниц Панели управления Клиента





google_tag_manager_settings

object

Группа настроек Google Tag Manager






use_google_tag_manager_service

bool

Признак Использовать сервис






tag_id

string

Идентификатор Google tag ID, который будет автоматически вставлен в HTML-код страниц Панели управления Клиента





cookiebot_cpm_settings

object

Группа настроек Cookiebot CMP






use_cookiebot_cpm_service

bool

Признак Использовать сервис






setting_id

string

Идентификатор настроек на стороне Cookiebot

meta

object

Дополнительная информация


server_current_time

string

Текущие дата и время сервера

Пример запроса

Bash
curl --location --request GET 'https://test.activeplatform.com/internal_api/customization_setting' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Accept: application/vnd.api+json' \
--header 'X-Api-Locale: en'

Пример ответа

JSON
{
    "data": {
        "id": "1",
        "type": "customization_setting",
        "attributes": {
            "global_settings": {
                "title": "ActivePlatform",
                "background_image": "https://storage.test.activeplatform.com/public/images/general_customization_setting/background_image/344/3297593.jpg",
                "show_copyright": true,
                "primary_color": "#3B9DDE",
                "header": {
                    "sections": [
                        "main",
                        "orders",
                        "quotes",
                        "billing",
                        "catalog",
                        "payments",
                        "analytics",
                        "subscriptions",
                        "balance_statement",
                        "closing_documents",
                        "guaranteed_payments"
                    ],
                    "navigation_menu_display": "inline",
                    "content": {
                        "links": []
                    }
                }
            },
            "footer": {
                "content": {
                    "links": [
                        {
                            "url": "https://example.com",
                            "name": "Link-1",
                            "priority": 0
                        },
                        {
                            "url": "https://example.org",
                            "name": "Link-2",
                            "priority": 0
                        },
                        {
                            "url": "https://example.net",
                            "name": "Link-3",
                            "priority": 0
                        }
                    ]
                },
                "contacts": {
                    "address": "A-Wing-614, Kanakia Wallstreet",
                    "email": "mail@example.com",
                    "phone": "+1-234-555-6789"
                },
                "copyright": "© 2024 Reseller",
                "socials": {
                    "facebook": "https://www.facebook.com/",
                    "instagram": "https://www.instagram.com/",
                    "linkedin": "https://www.linkedin.com/",
                    "youtube": "https://www.youtube.com/"
                }
            },
            "logo_settings": {
                "main_logotype_ccp": "https://storage.test.activeplatform.com/public/images/system_setting/logo/1/subs.png",
                "inverted_logo": "https://storage.test.activeplatform.com/public/images/system_setting/inverted_logo/1/logo_dark.png",
                "short_logo": "https://storage.test.activeplatform.com/public/images/system_setting/short_logo/1/logo_short.png",
                "mobile_logo": "https://storage.test.activeplatform.com/public/images/system_setting/short_logo/1/logo_mob.png",
                "stamp": null,
                "favicon": "https://storage.test.activeplatform.com/public/images/system_setting/favicon/1/favicon.png"
            },
            "pages": {
                "signin": {
                    "content": {
                        "welcome_text": "Welcome"
                    }
                },
                "signup": {
                    "content": {
                        "welcome_text": "Welcome"
                    }
                },
                "billing": {
                    "widgets": [
                        "balance",
                        "current_consumption",
                        "expected_amount_payments"
                    ]
                },
                "main": {
                    "content": {
                        "widgets": [
                            "balance",
                            "subscriptions_payments_filters",
                            "catalog",
                            "currency_rate",
                            "expenses",
                            "help",
                            "current_consumption",
                            "recommendations",
                            "stories"
                        ],
                        "info_messages": [
                            {
                                "from": null,
                                "to": null,
                                "created_at": "2022-11-25T08:19:27+00:00",
                                "importance": "high",
                                "text": "Test notification #1"
                            },
                            {
                                "from": "2023-01-01",
                                "to": "2023-03-01",
                                "created_at": "2022-12-22T09:01:57+00:00",
                                "importance": "low",
                                "text": "Test notification #2"
                            }
                        ],
                        "widget_help": [
                            {
                                "url": "https://docs.activeplatform.com",
                                "name": "RTFM",
                                "priority": 0
                            }
                        ]
                    }
                },
                "support": {
                    "redirect_url": "",
                    "content": {
                        "introduction_text": "Intro section text",
                        "sections": [
                            {
                                "title": "Section 1",
                                "text": "Text of Section 1",
                                "image": "https://storage.test.activeplatform.com/public/images/support_customization_setting/1/content_setting/1664.png",
                                "priority": 0
                            }
                        ],
                        "feedback_section": "Feedback section text"
                    }
                }
            },
            "custom_layout": {
                "billing_tab": {
                    "visible": true,
                    "name": null
                }
            },
            "external_services": {
                "captcha_settings": {
                    "use_captcha_service": true,
                    "site_key": "ABC123"
                },
                "google_tag_manager_settings": {
                    "use_google_tag_manager_service": true,
                    "tag_id": "GTM-ABC123"
                },
                "cookiebot_cpm_settings": {
                    "use_cookiebot_cpm_service": false,
                    "setting_id": null
                }
            }
        }
    },
    "meta": {
        "server_current_time": "2024-10-09T17:15:45.322089+0300"
    }
}