ConfigCat/mcp-server

Этот эндпоинт создаёт новый Config в указанном Product, идентифицируемом параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт создаёт новую среду в указанном продукте, идентифицированном параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот endpoint создаёт новую интеграцию в указанном продукте, определённом параметром `productId`. Параметр можно получить из endpoint'а [List Products](#operation/list-products). Словарь параметров различается в зависимости от типа интеграции (IntegrationType): - Datadog - `apikey`: Обязательный. API-ключ Datadog. - `site`: Сайт Datadog. Допустимые значения: `Us`, `Eu`, `Us1Fed`, `Us3`, `Us5`. По умолчанию: `Us`. - Slack Подключение интеграции Slack через Public Management API отправляет сообщения не через приложение ConfigCat Feature Flags Slack, а через входящий вебхук. - `incoming_webhook.url`: Обязательный. [URL входящего вебхука](https://api.slack.com/messaging/webhooks), куда интеграция должна отправлять сообщения. - `includeSensitiveData`: Установите `"true"`, чтобы включить [чувствительные (хешированные) значения сравнения](https://configcat.com/docs/targeting/targeting-rule/user-condition/#confidential-text-comparators). По умолчанию интеграция маскирует эти значения в отправляемых сообщениях. Рекомендуем скрывать чувствительные значения сравнения для общих или публичных каналов Slack. - Amplitude - `apiKey`: Обязательный. API-ключ Amplitude. - `secretKey`: Обязательный. Секретный ключ Amplitude. - Mixpanel - `serviceAccountUserName`: Обязательный. Имя пользователя сервисного аккаунта Mixpanel. - `serviceAccountSecret`: Обязательный. Секрет сервисного аккаунта Mixpanel. - `projectId`: Обязательный. Идентификатор проекта Mixpanel. - `server`: Сервер Mixpanel. Допустимые значения: `StandardServer`, `EUResidencyServer`. По умолчанию: `StandardServer`. - Twilio Segment - `writeKey`: Обязательный. Ключ записи Twilio Segment. - `server`: Сервер Twilio Segment. Допустимые значения: `Us`, `Eu`. По умолчанию: `Us`. - PubNub (в разработке)

Этот endpoint создаёт новую Permission Group в указанном Product, идентифицируемом параметром `productId`, который можно получить из endpoint [List Products](#operation/list-products).

Этот endpoint создает новый продукт в указанной организации, идентифицируемой параметром `organizationId`, который можно получить из endpoint [List Organizations](#operation/list-organizations).

Этот эндпоинт создаёт новый Segment в указанном Product, идентифицированном параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт создаёт новый Feature Flag или Setting в указанной Config, заданной параметром `configId`. **Важно:** Атрибут `key` должен быть уникальным в пределах данной Config.

Этот эндпоинт создаёт новый тег в указанном товаре, идентифицированном параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт создаёт новый Webhook в указанном Product, идентифицируемом параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт удаляет Config, идентифицированный параметром `configId`.

Этот endpoint удаляет окружение, идентифицированное параметром `environmentId`. Если флаг `cleanupAuditLogs` установлен в true, он также удаляет записи журнала аудита, связанные с окружением (за исключением записей `Created a new environment` и `Deleted an environment`).

Этот endpoint удаляет интеграцию, идентифицируемую параметром `integrationId`.

Этот эндпоинт удаляет Invitation, идентифицируемый параметром `invitationId`.

Этот эндпоинт удаляет участника, заданного `userId`, из организации, указанной параметром `organizationId`.

Этот endpoint удаляет Permission Group, идентифицированную параметром `permissionGroupId`.

Этот endpoint удаляет Product, определённый параметром `productId`.

Этот эндпоинт удаляет участника, идентифицированного параметром `userId`, из указанного продукта, идентифицированного параметром `productId`.

Эта конечная точка удаляет Segment, идентифицируемый параметром `segmentId`.

Этот эндпоинт удаляет Feature Flag или Setting из указанного Config, идентифицированного параметром `configId`.

Этот endpoint удаляет тег, идентифицируемый параметром `tagId`. Чтобы удалить тег из Feature Flag или Setting, используйте endpoint [Update Flag](#operation/update-setting).

Этот эндпоинт удаляет Webhook, идентифицированный параметром `webhookId`.

Получает ссылки на использование флага функции или настройки.

Этот endpoint возвращает метаданные Config, идентифицированного по `configId`.

Этот endpoint возвращает метаданные Environment, идентифицированного по `environmentId`.

Возвращает метаданные интеграции, идентифицированной по `integrationId`.

Этот эндпоинт возвращает метаданные Permission Group, идентифицированной по `permissionGroupId`.

Этот эндпоинт возвращает метаданные продукта, идентифицируемого по `productId`.

Этот endpoint возвращает настройки Продукта, идентифицированного по `productId`.

Эта конечная точка возвращает SDK Key для вашего Config в указанном Environment.

Этот эндпоинт возвращает метаданные сегмента, идентифицированного по `segmentId`.

Этот endpoint возвращает атрибуты метаданных Feature Flag или Setting, идентифицированных параметром `settingId`.

Этот endpoint возвращает значение Feature Flag или Setting в указанном Environment, определяемом параметром `environmentId`. Наиболее важные атрибуты в ответе: `value`, `rolloutRules` и `percentageRules`. `value` представляет то, что получат клиенты, когда запросы оценки наших SDK не совпадают ни с одним из определённых правил Targeting или Percentage, или когда нет дополнительных правил для оценки. Атрибуты `rolloutRules` и `percentageRules` представляют текущую конфигурацию правил Targeting и Percentage для данного Feature Flag или Setting в **упорядоченной** коллекции, то есть порядок возвращаемых правил соответствует порядку оценки. Подробнее об этих правилах можно прочитать [здесь](https://configcat.com/docs/targeting/targeting-overview).

Этот эндпоинт возвращает значение указанного Config's Feature Flags или Settings, определяемое параметром `configId`, в указанной среде, определяемой параметром `environmentId`. Самые важные атрибуты в ответе — `value`, `rolloutRules` и `percentageRules`. `value` представляет то, что получат клиенты, когда запросы оценки наших SDK не совпадают ни с одним из заданных правил таргетинга или процентных правил, или когда нет дополнительных правил для оценки. Атрибуты `rolloutRules` и `percentageRules` представляют текущую конфигурацию правил таргетинга и процентных правил для конкретного Feature Flag или Setting в **упорядоченной** коллекции, то есть порядок возвращаемых правил соответствует порядку оценки. Подробнее об этих правилах читайте [здесь](https://configcat.com/docs/targeting/targeting-overview/).

Эта конечная точка возвращает все значения Feature Flag и Setting для Config, идентифицированной параметром `configId`, в указанной среде (Environment), идентифицированной параметром `environmentId`. Наиболее важные поля в ответе: `defaultValue`, `targetingRules`. `defaultValue` представляет то, что клиенты получат, когда запросы оценки наших SDK не соответствуют ни одному из определенных Targeting Rules, или когда нет дополнительных правил для оценки. `targetingRules` представляет текущую конфигурацию Targeting Rule для данного Feature Flag или Setting в **упорядоченной** коллекции, что означает, что порядок возвращаемых правил соответствует порядку оценки. Подробнее об этих правилах можно прочитать [здесь](https://configcat.com/docs/targeting/targeting-overview/). `percentageEvaluationAttribute` представляет собой пользовательский атрибут [User Object](https://configcat.com/docs/targeting/user-object/), который должен использоваться для [процентной оценки](https://configcat.com/docs/targeting/percentage-options/) Feature Flag или Setting.

Этот endpoint возвращает значение Feature Flag или настройки в указанном окружении, заданном параметром `environmentId`. Самые важные поля в ответе: `defaultValue`, `targetingRules` и `percentageEvaluationAttribute`. Поле `defaultValue` определяет, что получат клиенты, когда запросы оценки наших SDK не соответствуют ни одному из заданных Targeting Rules, или когда нет дополнительных правил для оценки. Поле `targetingRules` содержит текущую конфигурацию Targeting Rules для данного Feature Flag или настройки в **упорядоченной** коллекции: порядок возвращаемых правил соответствует порядку оценки. Подробнее об этих правилах читайте [здесь](https://configcat.com/docs/targeting/targeting-overview/). Поле `percentageEvaluationAttribute` задаёт пользовательский атрибут [User Object](https://configcat.com/docs/targeting/user-object/), который необходимо использовать для [процентной оценки](https://configcat.com/docs/targeting/percentage-options/) Feature Flag или настройки.

Этот эндпоинт возвращает метаданные тега, идентифицированного по `tagId`.

Этот эндпоинт возвращает метаданные вебхука с указанным `webhookId`.

Этот эндпоинт возвращает ключи подписи вебхука, заданного через `webhookId`. Ключи подписи гарантируют, что полученные вами запросы вебхука действительно отправлены ConfigCat. <a href="https://configcat.com/docs/advanced/notifications-webhooks/#verifying-webhook-requests" target="_blank" rel="noopener noreferrer">Здесь</a> можно подробнее узнать о проверке запросов вебхука.

Этот endpoint приглашает Member в указанный Product, идентифицируемый параметром `productId`.

Этот endpoint возвращает список записей журнала аудита для заданного продукта. Результат можно опционально отфильтровать по Config и/или Environment. Если ни `fromUtcDateTime`, ни `toUtcDateTime` не заданы, будут возвращены записи журнала аудита за **последние 7 дней**. Расстояние между `fromUtcDateTime` и `toUtcDateTime` не может превышать **30 дней**.

Этот эндпоинт возвращает список Configs, которые принадлежат указанному Product, идентифицированному параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт возвращает список Environments, принадлежащих указанному Product, определяемому параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт возвращает список интеграций, принадлежащих указанному продукту, идентифицируемому параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт возвращает список элементов журнала аудита для заданной организации, а результат можно дополнительно отфильтровать по Product, Config или Environment. Если ни `fromUtcDateTime`, ни `toUtcDateTime` не заданы, возвращаются записи аудита за **последние 7 дней**. Расстояние между `fromUtcDateTime` и `toUtcDateTime` не может превышать **30 дней**.

Этот эндпоинт возвращает список участников, принадлежащих указанной организации, идентифицированной параметром `organizationId`. Результаты могут различаться в зависимости от уровня доступа пользователя, вызывающего эндпоинт: - При вызове с привилегиями администратора организации результат содержит каждого участника организации. - При вызове без привилегий администратора организации результат содержит каждого администратора организации вместе с участниками тех продуктов, где у вызывающего есть разрешение `Team members and permission groups` (`canManageMembers`).

Этот конечный узел возвращает список организаций, принадлежащих пользователю.

Этот эндпоинт возвращает список ожидающих приглашений в рамках указанного Product, идентифицированного параметром `productId`.

Этот endpoint возвращает список ожидающих приглашений в указанной организации, идентифицируемой параметром `organizationId`.

Этот endpoint возвращает список групп разрешений, принадлежащих данному продукту, заданному параметром `productId`, который можно получить из endpoint [List Products](#operation/list-products).

Этот эндпоинт возвращает предопределённые варианты и их использование в средах для Feature Flag или настройки, определённой параметром `settingId`.

Эта конечная точка возвращает список участников, принадлежащих заданному продукту, идентифицируемому параметром `productId`.

Этот endpoint возвращает список Продуктов, принадлежащих пользователю.

Этот эндпоинт возвращает список сегментов, принадлежащих данному продукту, идентифицируемому параметром `productId`, который можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт возвращает список флагов функций и настроек, определённых в указанной конфигурации, идентифицируемой параметром `configId`.

Этот endpoint возвращает список Settings, имеющих указанный Tag, определяемый параметром `tagId`.

Этот endpoint возвращает список Zombie (stale) флагов для заданного Product, и результат можно опционально отфильтровать по различным параметрам.

Этот эндпоинт возвращает список тегов в указанном продукте, идентифицируемом параметром `productId`.

Этот эндпоинт возвращает список вебхуков, принадлежащих заданному продукту, который идентифицируется параметром `productId`. Значение `productId` можно получить из эндпоинта [List Products](#operation/list-products).

Этот эндпоинт заменяет значения указанных Feature Flags или Settings заданного Config, идентифицированного параметром `configId`, в указанном Environment, идентифицированном параметром `environmentId`. Через этот эндпоинт можно изменять только атрибуты `value`, `rolloutRules` и `percentageRules`. **Важно:** поскольку этот эндпоинт выполняет полную замену, нужно указывать каждый атрибут, который вы не хотите менять, в его исходном состоянии. Если какой-то атрибут не указан, он сбросится. Например: у нас есть следующий ресурс: ```json { "settingValues": [ { "rolloutPercentageItems": [ { "percentage": 30, "value": true }, { "percentage": 70, "value": false } ], "rolloutRules": [], "value": false, "settingId": 1 } ] } ``` Если мы отправим тело запроса на замену, как показано ниже: ```json { "settingValues": [ { "value": true, "settingId": 1 } ] } ``` То, помимо того, что значение по умолчанию станет `true`, все Percentage Rules будут удалены. В итоге мы получим такой ответ: ```json { "settingValues": [ { "rolloutPercentageItems": [], "rolloutRules": [], "value": true, "setting": { "settingId": 1 } } ] } ``` Свойство `rolloutRules` описывает два типа правил: - **Targeting rules**: когда требуется добавить или обновить правило таргетинга, обязательны члены `comparator`, `comparisonAttribute` и `comparisonValue`. - **Segment rules**: когда требуется добавить или обновить правило сегмента, обязательны `segmentId` (идентифицирует нужный сегмент) и член `segmentComparator`.

Этот эндпоинт массово обновляет Feature Flags и Settings конфигурации (Config), идентифицированной по параметру `configId`, в указанном окружении, идентифицированном по параметру `environmentId`. Обновляются только те Feature Flags и Settings, которые входят в запрос; все остальные остаются нетронутыми. **Важно:** этот эндпоинт полностью заменяет те Feature Flags и Settings, которые указаны в запросе. Поэтому важно задать каждое поле, которое вы не хотите менять, в исходном состоянии. Если поле не указано, оно сбросится. Например, у нас есть следующий ресурс Feature Flag: ```json { "settingFormulas": [ { "defaultValue": { "boolValue": false }, "targetingRules": [ { "conditions": [ { "userCondition": { "comparisonAttribute": "Email", "comparator": "sensitiveTextEquals", "comparisonValue": { "stringValue": "test@example.com" } } } ], "percentageOptions": [], "value": { "boolValue": true } } ], "settingId": 1 } ] } ``` Если отправить запрос на массовую замену в таком виде: ```json { "updateFormulas": [ { "defaultValue": { "boolValue": false }, "settingId": 1 } ] } ``` Тогда, помимо того, что значение по умолчанию устанавливается в `true`, все правила таргетинга соответствующего Feature Flag удаляются. И мы получаем ответ следующего вида: ```json { "settingFormulas": [ { "defaultValue": { "boolValue": false }, "targetingRules": [], "setting": { "settingId": 1 } } ] } ```

Эта конечная точка заменяет полное значение Feature Flag или Setting, определяемого параметром `settingId`. **Важно:** Поскольку эта конечная точка выполняет полную замену, важно указать каждый другой атрибут, который вы не хотите изменять, в его исходном состоянии. Если не указать какой-либо из них, он будет сброшен.

Этот эндпоинт заменяет всё значение Feature Flag или Setting в указанном окружении. Через этот эндпоинт можно изменить только атрибуты `value`, `rolloutRules` и `percentageRules`. **Важно:** поскольку этот эндпоинт выполняет полную замену, нужно указать все остальные атрибуты, которые вы не хотите менять, в их исходном состоянии. Если какой-то атрибут не указан, он сбросится. Например, у нас есть такой ресурс: ```json { "rolloutPercentageItems": [ { "percentage": 30, "value": true }, { "percentage": 70, "value": false } ], "rolloutRules": [], "value": false } ``` Если мы отправляем тело запроса на замену как ниже: ```json { "value": true } ``` То помимо того, что значение по умолчанию станет `true`, все процентные правила удаляются. В ответ мы получим: ```json { "rolloutPercentageItems": [], "rolloutRules": [], "value": true } ``` Свойство `rolloutRules` описывает два типа правил: - **Правила таргетинга**: когда требуется добавить или обновить правило таргетинга, необходимы члены `comparator`, `comparisonAttribute` и `comparisonValue`. - **Правила сегментов**: когда требуется добавить или обновить правило сегмента, необходимы члены `segmentId` (идентификатор нужного сегмента) и `segmentComparator`.

Этот endpoint заменяет значение и правила таргетинга (Targeting Rules) Feature Flag или Setting в указанном окружении, идентифицируемом по <a target="_blank" rel="noopener noreferrer" href="https://app.configcat.com/sdkkey">SDK key</a>, переданному в заголовке `X-CONFIGCAT-SDKKEY`. Этот endpoint изменяет только поля `defaultValue`, `targetingRules` и `percentageEvaluationAttribute`. **Важно:** Так как этот endpoint выполняет полную замену, все остальные поля, которые вы не хотите менять, нужно явно установить в исходное состояние. Если какое-то поле не указано, оно сбросится. Например, у нас есть следующий ресурс Feature Flag. ```json { "defaultValue": { "boolValue": false }, "targetingRules": [ { "conditions": [ { "userCondition": { "comparisonAttribute": "Email", "comparator": "sensitiveTextEquals", "comparisonValue": { "stringValue": "test@example.com" } } } ], "percentageOptions": [], "value": { "boolValue": true } } ] } ``` Если отправить тело запроса на замену как показано ниже: ```json { "defaultValue": { "boolValue": true } } ``` Тогда, помимо того что значение, возвращаемое по умолчанию, устанавливается в `true`, все правила таргетинга (Targeting Rules) удаляются. В ответ получаем: ```json { "defaultValue": { "boolValue": true }, "targetingRules": [] } ```

Этот endpoint заменяет полное значение вебхука, заданного параметром `webhookId`. **Важно:** Поскольку этот endpoint выполняет полную замену, важно задать каждый остальной атрибут, который вы не хотите менять, в его исходном состоянии. Если какой-то атрибут не указать, он будет сброшен.

Этот endpoint обновляет Config, определённый параметром `configId`.

Этот endpoint обновляет Environment, идентифицируемый параметром `environmentId`.

Этот эндпоинт обновляет Config, идентифицируемый параметром `integrationId`. Словарь Parameters различается для каждого IntegrationType: - Datadog - `apikey`: Обязательный. API-ключ Datadog. - `site`: Сайт Datadog. Допустимые значения: `Us`, `Eu`, `Us1Fed`, `Us3`, `Us5`. По умолчанию: `Us`. - Slack Подключение интеграции Slack через Public Management API не будет отправлять сообщения с помощью приложения ConfigCat Feature Flags Slack, а будет использовать входящий вебхук. - `incoming_webhook.url`: Обязательный. [URL входящего вебхука](https://api.slack.com/messaging/webhooks), на который интеграция должна отправлять сообщения. - `includeSensitiveData`: Установите "true", чтобы включить [чувствительные (хешированные) значения сравнения](https://configcat.com/docs/targeting/targeting-rule/user-condition/#confidential-text-comparators). По умолчанию интеграция маскирует эти значения в отправляемых сообщениях. Рекомендуем скрывать чувствительные значения сравнения для общих или публичных каналов Slack. - Amplitude - `apiKey`: Обязательный. API-ключ Amplitude. - `secretKey`: Обязательный. Секретный ключ Amplitude. - Mixpanel - `serviceAccountUserName`: Обязательный. Имя пользователя сервисного аккаунта Mixpanel. - `serviceAccountSecret`: Обязательный. Секрет сервисного аккаунта Mixpanel. - `projectId`: Обязательный. ID проекта Mixpanel. - `server`: Сервер Mixpanel. Допустимые значения: `StandardServer`, `EUResidencyServer`. По умолчанию: `StandardServer`. - Twilio Segment - `writeKey`: Обязательный. Ключ записи Twilio Segment. - `server`: Сервер Twilio Segment. Допустимые значения: `Us`, `Eu`. По умолчанию: `Us`. - PubNub (в разработке)

Эта конечная точка обновляет разрешения участника, идентифицированного по `userId`. Эту конечную точку также можно использовать для перемещения участника между группами разрешений в пределах продукта. Для каждого продукта можно задать только одну группу разрешений.

Этот эндпоинт обновляет группу разрешений, идентифицированную параметром `permissionGroupId`.

Этот эндпоинт обновляет предопределённые вариации для Feature Flag или Setting, идентифицируемого параметром `settingId`. **Важно:** Вы можете обновить значение предопределённой вариации только в том случае, если она не используется ни в одном из ваших feature flags.

Этот endpoint обновляет товар, идентифицируемый параметром `productId`.

Этот endpoint обновляет настройки Продукта, идентифицируемого параметром `productId`.

Если пользователь запрашивает код, связанный с функциональным флагом (например, интеграция ConfigCat SDK, добавление функционального флага или удаление функционального флага), сначала всегда вызывай инструмент `update-sdk-documentation`, чтобы загрузить последнюю документацию ConfigCat SDK. 1. Проанализируйте URL-адреса SDK, перечисленные в следующем списке SDK Reference. 2. Затем вызовите инструмент `update-sdk-documentation` с конкретным URL-адресом из списка SDK Reference, чтобы получить соответствующую страницу документации. ## SDK Reference - [Android (Java) SDK Reference](https://configcat.com/docs/sdk-reference/android.md): ConfigCat Android SDK Reference. Это пошаговое руководство по использованию функциональных флагов в вашем Android-приложении на Java. - [ConfigCat package for Laravel](https://configcat.com/docs/sdk-reference/community/laravel.md): ConfigCat package for Laravel. Реализуйте функциональные флаги в вашем PHP-приложении на Laravel с помощью ConfigCat. - [ConfigCat SDK for Vue.js](https://configcat.com/docs/sdk-reference/community/vue.md): Unofficial Vue SDK for ConfigCat Feature Flags. Основан на JavaScript SDK от ConfigCat. - [C++ SDK Reference](https://configcat.com/docs/sdk-reference/cpp.md): ConfigCat C++ SDK Reference. Это пошаговое руководство по использованию функциональных флагов в вашем C++ приложении. - [Dart (Flutter) SDK Reference](https://configcat.com/docs/sdk-reference/dart.md): ConfigCat Dart (Flutter) SDK Reference. Это пошаговое руководство по использованию функциональных флагов в ваших Dart (Flutter) приложениях. - [.NET SDK Reference](https://configcat.com/docs/sdk-reference/dotnet.md): ConfigCat .NET SDK Reference. Это пошаговое руководство по использованию функциональных флагов в вашем .NET приложении. - [Using the ConfigCat SDK in DI‑Based .NET Applications](https://configcat.com/docs/sdk-reference/dotnet/generic-host.md): Использование ConfigCat SDK в DI‑Based .NET приложениях. Это пошаговое руководство по использованию функциональных флагов в ваших ASP.NET Core приложениях и других современных .NET-приложениях, построенных на .NET Generic Host…

Этот эндпоинт обновляет Segment, заданный параметром `segmentId`.

Этот эндпоинт обновляет метаданные фичефлага или настройки с помощью набора операций [JSON Patch](https://jsonpatch.com) в указанной конфигурации. Через этот эндпоинт можно изменять только атрибуты `name`, `hint` и `tags`. Атрибут `tags` — это просто набор [идентификаторов тегов](#operation/list-tags), привязанных к данной настройке. Преимущество JSON Patch в том, что вы можете описать отдельные операции обновления ресурса, не затрагивая атрибуты, которые не хотите менять. Например: у нас есть следующий ресурс. ```json { "settingId": 5345, "key": "myGrandFeature", "name": "Tihs is a naem with soem typos.", "hint": "This flag controls my grandioso feature.", "settingType": "boolean", "tags": [ { "tagId": 0, "name": "sample tag", "color": "whale" } ] } ``` Если мы отправим тело запроса на обновление как показано ниже (оно изменяет `name` и добавляет уже существующий тег с id `2`): ```json [ { "op": "replace", "path": "/name", "value": "This is the name without typos." }, { "op": "add", "path": "/tags/-", "value": 2 } ] ``` Обновятся только `name` и `tags`, все остальные атрибуты останутся без изменений. В ответ мы получим следующее: ```json { "settingId": 5345, "key": "myGrandFeature", "name": "This is the name without typos.", "hint": "This flag controls my grandioso feature.", "settingType": "boolean", "tags": [ { "tagId": 0, "name": "sample tag", "color": "whale" }, { "tagId": 2, "name": "another tag", "color": "koala" } ] } ```

Этот endpoint обновляет значение Feature Flag или Setting с помощью набора операций [JSON Patch](https://jsonpatch.com) в указанном окружении. С помощью этого endpoint'а можно изменять только атрибуты `value`, `rolloutRules` и `percentageRules`. Преимущество использования JSON Patch в том, что вы можете описать отдельные операции обновления ресурса, не затрагивая атрибуты, которые не нужно менять. Он поддерживает переупорядочивание коллекций, поэтому его можно использовать и для изменения порядка правил таргетинга Feature Flag или Setting. Например: у нас есть следующий ресурс. ```json { "rolloutPercentageItems": [ { "percentage": 30, "value": true }, { "percentage": 70, "value": false } ], "rolloutRules": [], "value": false } ``` Если мы отправим тело запроса на обновление, как показано ниже: ```json [ { "op": "replace", "path": "/value", "value": true } ] ``` Будет установлено только значение по умолчанию `true`, а все Percentage Rules останутся без изменений. В ответ мы получим следующее: ```json { "rolloutPercentageItems": [ { "percentage": 30, "value": true }, { "percentage": 70, "value": false } ], "rolloutRules": [], "value": true } ``` Свойство `rolloutRules` описывает два типа правил: - **Правила таргетинга**: чтобы добавить или обновить правило таргетинга, обязательны члены `comparator`, `comparisonAttribute` и `comparisonValue`. - **Правила сегментов**: чтобы добавить или обновить правило сегмента, обязательны члены `segmentId`, определяющий нужный сегмент, и `segmentComparator`.

Этот эндпоинт обновляет значение Feature Flag или Setting с помощью набора операций [JSON Patch](https://jsonpatch.com) в указанном окружении (Environment). С помощью этого эндпоинта можно изменять только поля `defaultValue`, `targetingRules` и `percentageEvaluationAttribute`. Преимущество JSON Patch в том, что вы можете описывать отдельные операции обновления ресурса, не затрагивая атрибуты, которые не нужно менять. Он поддерживает переупорядочивание коллекций, поэтому его также можно использовать для изменения порядка правил таргетинга (targeting rules) Feature Flag или Setting. Пример: у нас есть следующий ресурс Feature Flag. ```json { "defaultValue": { "boolValue": false }, "targetingRules": [ { "conditions": [ { "userCondition": { "comparisonAttribute": "Email", "comparator": "sensitiveTextEquals", "comparisonValue": { "stringValue": "test@example.com" } } } ], "percentageOptions": [], "value": { "boolValue": true } } ] } ``` Если мы отправим такой запрос на обновление: ```json [ { "op": "replace", "path": "/targetingRules/0/value/boolValue", "value": true } ] ``` В результате `value` первого правила таргетинга будет установлено в `false`, а все остальные поля останутся без изменений. Ответ будет таким: ```json { "defaultValue": { "boolValue": false }, "targetingRules": [ { "conditions": [ { "userCondition": { "comparisonAttribute": "Email", "comparator": "sensitiveTextEquals", "comparisonValue": { "stringValue": "test@example.com" } } } ], "percentageOptions": [], "value": { "boolValue": false } } ] } ```

Этот эндпоинт обновляет тег, идентифицируемый параметром `tagId`.

Этот эндпоинт обновляет вебхук, идентифицированный параметром `webhookId`, с помощью набора операций [JSON Patch](https://jsonpatch.com). Преимущество использования JSON Patch в том, что вы можете описать отдельные операции обновления ресурса, не затрагивая атрибуты, которые не хотите менять. Например: у нас есть следующий ресурс. ```json { "webhookId": 6, "url": "https://example.com/hook", "httpMethod": "post", "content": "null", "webHookHeaders": [] } ``` Если мы отправим тело запроса на обновление, как показано ниже (оно изменяет поле `content` и добавляет новый HTTP-заголовок): ```json [ { "op": "replace", "path": "/content", "value": "Some webhook content." }, { "op": "add", "path": "/webHookHeaders/-", "value": { "key": "X-Custom-Header", "value": "Custom header value" } } ] ``` Будут обновлены только `content` и `webHookHeaders`, все остальные атрибуты останутся неизменными. Поэтому мы получим такой ответ: ```json { "webhookId": 6, "url": "https://example.com/hook", "httpMethod": "post", "content": "Some webhook content.", "webHookHeaders": [ { "key": "X-Custom-Header", "value": "Custom header value", "isSecure": false } ] } ```