Перейти до вмісту

Пакетне встановлення тегів профілів браузера

Request

Замінює теги вибраних ресурсів. Потрібні право керування тегами та доступ до цілей. Назви порівнюються точно в межах команди: відсутні теги створюються, наявні використовуються повторно з оновленням кольору. Зміна кольору впливає також на інші ресурси з цим тегом. Повторення назв в одному запиті заборонено. Порожній масив tags видаляє лише зв’язки, зберігаючи визначення тегів і групи. Операція синхронна, data дорівнює null. Після тайм-ауту перевірте цілі та /api/envtag/all перед повтором; ключа ідемпотентності немає.

Задокументовані бізнес-помилки: 15003, 15004, 19039, 19173, 19193. Значення кодів див. у Error Codes. Будь-яка операція може додатково повернути загальні коди.

Bodyapplication/jsonrequired
Any of:
envIdsArray of strings, non-emptyrequired

ID профілів. Укажіть непорожній envIds або uniqueIds; непорожній envIds має пріоритет. Діють наявні правила пакетного вибору та перевірки прав.

uniqueIdsArray of integers

Порядкові номери профілів, які використовуються за порожнього або відсутнього envIds.

Example:
[ 1 ]
tagsArray of objectsrequired

Теги для заміни всіх поточних зв’язків. Порожній масив видаляє зв’язки, але не визначення тегів.

curl -i -X POST \
  http://127.0.0.1:40000/api/env/setTags/batch \
  -H 'Content-Type: application/json' \
  -d '{
    "envIds": [
      "1993244721490239488"
    ],
    "tags": [
      {
        "tagName": "Sales",
        "tagColor": "blue"
      }
    ]
  }'

Responses

Успішно. Зв’язки тегів оновлено синхронно; data дорівнює null.

Bodyapplication/json
codeinteger
Example:0
msgstring or null
requestIdstring
datanull
Response
{ "code": 0, "msg": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d", "data": null }