Функциональное обновление полей базы

При использовании запросов для обновления полей профиля можно передавать дополнительные инструкции прямо в поле.

Инструкция имеет определенную структуру:

{
    "action": "set",
    "value": "x",
}

Поле action может принимать одно из следущих значенией:

action	Назначение	Тип поля	value
set	Работает так же, как и простое обновление поля, устанавливает значение	все типы: date, string, enum, phone, int, float, tags, object, arr_object	Зависит от типа поля в бд
unset	Удаляет поле из структуры профиля (для всех полей, кроме email)	все типы: date, string, enum, phone, int, float, tags, object, arr_object	Нет
incr	Увеличивает значение поля	int, float	Число
add	Добавляет элементы в поле профиля	tags, arr_object	Массив строк
delete	Удаляет элементы из поля профиля	tags, arr_object	Массив строк
upsert	Устанавливает значение из поля valueв свойство, указанное в поле submatch	object	Зависит от типа поля

примечание

Для типов данных object, arr_object необходимо передавать поля value и submatch (путь к свойству, значение которого необходимо обновить).

Пример запроса profiles/update, уменьшающий значение одного поля и увеличивающий другое:

{
	"token": "abcdefghijklmnqrstuvwxyz",   
	"db_id": 24,
	"profile_id": "5a5b64a969d4265b958b9ac3",
	"data": {
		"checks": {
			"action": "incr",
			"value": 1000
		},
   		"returns":  {
			"action": "incr",
			"value": -1000
    	}
  	}
}

Пример запроса profiles/update, манипулирующий тегами:

{
  "token": "abcdefghijklmnqrstuvwxyz",
  "db_id": 24,
  "profile_id": "5a5b64a969d4265b958b9ac3",
  "data": {
    "category": {
       "action": "add",
       "value": ["cars", "cats"]
    }
  }
}

Пример запроса profiles/update, который обновит поле "x" в объекте:

{ 
  "token": "abcdefghijklmnqrstuvwxyz",  
  "db_id": 24,
  "profile_id": "5a5b64a969d4265b958b9ac3",
  "data": {
    "myObject": {
       "action": "upsert",
       "value": "y",
       "submatch": "x"
    }
  }
}

Пример запроса profiles/update, который установит новое значение (value) для всех элементов объекта, содержащих указанное свойство (submatch):

Запрос

{   
  "token": "abcdefghijklmnqrstuvwxyz",
  "db_id": 24,
  "profile_id": "5a5b64a969d4265b958b9ac3",
  "data": {
    "myArrOfObject": {
       "action": "upsert",
       "value": {"x": "y", "z": 1},
       "submatch": "x"
    }
  }
}

Объект

{
    {
       "A": 1,
       "x": false,
    },
    {
       "B": "test"
    },
    {
       "x": "test",
       "C": true
    }
 }

Обновленный объект

{
    {
       "A": 1,
       "x": {"x": "y", "z": 1},
    },
    {
       "B": "test"
    },
    {
       "x": {"x": "y", "z": 1},
       "C": true
    }
 }

примечание

Если у полей с типом object и object_arr отсутствует свойство, которое вы хотите изменить (action), то это свойство создается автоматически.