title: "Поле" summary: | API методы для полей. redirect_from: - /ru/docs/latest/api/field
Поле¶
API методы для полей.
DELETE /api/field/:id/dimension¶
Удаляет измерение связанное с полем по ID.
Параметры:¶
idцелое число больше нуля.
GET /api/field/:id¶
Получить Поле по ID.
Параметры:¶
idцелое число больше нуля.include_editable_data_modelдопустимая логическая строка (trueилиfalse).
GET /api/field/:id/related¶
Возвращает связанные сущности.
Параметры:¶
idцелое число больше нуля.
GET /api/field/:id/remapping/:remapped-id¶
Получить переопределённую карту значений полей.
Параметры:¶
-
idцелое число больше нуля. -
remapped-idцелое число больше нуля. -
valueнепустая строка.
GET /api/field/:id/search/:search-id¶
Искать значения поля с search-id которое начинается с value.
Параметры:¶
-
idцелое число больше нуля. -
search-idцелое число больше нуля. -
valueнепустая строка.
GET /api/field/:id/summary¶
Получить количество и количество различных значений для поля с ID.
Параметры:¶
idцелое число больше нуля.
GET /api/field/:id/values¶
Если значение Поля has_field_values является списком :list, то возвращает список всех различных значений Поля или переопределённого Поля, и (если определено пользователем) карту переопределённых значений.
Параметры:¶
idцелое число больше нуля.
POST /api/field/:id/dimension¶
Устанавливает измерение для заданного поля с ID.
Параметры:¶
-
idцелое число больше нуля. -
typeзначение должно быть одним из:internal,external. -
dimension-nameнепустая строка. -
human_readable_field_idцелое число больше нуля или null.
POST /api/field/:id/discard_values¶
Скрыть значения, принадлежащие этому полю. Применяется только к полям, имеющим FieldValues. Если установлена автоматическая синхронизация FieldValues, они будут созданы заново в следующем цикле.
Параметры:¶
id
POST /api/field/:id/rescan_values¶
Вручную инициирует обновление значений FieldValues для этого поля. Применяется только к полям, которые имеют право на FieldValues.
Параметры:¶
idцелое число больше нуля.
POST /api/field/:id/values¶
Обновляет значения полей читаемых значений для Field, чей семантический тип является category/city/state/country или чей тип базы type/Boolean. Читаемое значение опционально.
Параметры:¶
-
idцелое число больше нуля. -
value-pairsпоследовательность векторов, содержащая ровно 1 элемент любого типа, или вектор, содержащий ровно 2 элемента: любого типа и непустая строка.
PUT /api/field/:id¶
Обновить поле Field с ID.
Параметры:¶
-
visibility_typenull или одно из:retired,sensitive,normal,hidden,details-only. -
display_nameнепустая строка или null. -
points_of_interestнепустая строка или null. -
descriptionнепустая строка или null. -
semantic_typenull или допустимый семантический или реляционный тип (ключевое слово или строка). -
coercion_strategynull или допустимая стратегия принуждения (ключевое слово или строка). -
has_field_valuesnull или одно из:auto-list,search,list,none. -
settingsкарта или null. -
caveatsнепустая строка или null. -
fk_target_field_idцелое число больше нуля или null. -
nfc_pathnull или последовательность значений, являющаяся непустой строкой. -
idцелое число больше нуля. -
json_unfoldingлогическое значение или null.