Таблица¶
/api/table методы.
GET /api/table/
¶
Получить все Tables
.
GET /api/table/:id
¶
Получить Table
по ID.
Параметры:¶
id
целое число больше нуля.include_editable_data_model
логическое значение, может быть пустым.
GET /api/table/:id/fks
¶
Получить все внешние ключи, назначением которых является поле Field
, принадлежащее к этой таблице Table
.
Параметры:¶
id
целое число больше нуля.
GET /api/table/:id/query_metadata
¶
Получить метаданные о Table
, необходимые для запуска запросов. Возвращает БД, поля, значения полей, FK полей. При передаче include_hidden_fields=true
в ответ будут включены все скрытые поля Fields
. По умолчанию false
. При передаче include_sensitive_fields=true
в ответ будут включены любые чувствительные поля Fields
. По умолчанию false
. При передаче include_editable_data_model=true
проверит, что текущий пользователь имеет права на запись для таблицы модели данных, если false
, то проверяет, есть ли у них права доступа к данным для таблицы. По умолчанию false
.
Эти параметры предоставляются для использования на странице редактирования метаданных администратора.
Параметры:¶
id
include_sensitive_fields
логическое значение, может быть пустым.include_hidden_fields
логическое значение, может быть пустым.include_editable_data_model
логическое значение, может быть пустым.
GET /api/table/card__:id/fks
¶
Возвращает FK для виртуальной таблицы для Карточки. Возвращает всегда пустое значение, поэтому этот метод служит в основном в качестве заглушки, чтобы избежать необходимости что-либо менять в интерфейсе пользователя.
GET /api/table/card__:id/query_metadata
¶
Возвращает метаданные для виртуальной таблицы для Карточки.
Параметры:¶
id
POST /api/table/:id/discard_values
¶
Скрывает значения полей FieldValues, принадлежащие полям в этой таблице. Применяется только к полям, имеющим значения FieldValues. Если база данных этой таблицы настроена на автоматическую синхронизацию значений полей, они будут воссозданы в следующем цикле синхронизации.
Параметры:¶
id
целое число больше нуля.
POST /api/table/:id/rescan_values
¶
Вручную инициирует обновление FieldValues для полей, принадлежащих этой таблице. Применяется только к полям, которые имеют право на FieldValues.
Параметры:¶
id
целое число больше нуля.
PUT /api/table/
¶
Обновляет все таблицы Table
по ids
.
Параметры:¶
ids
непустой массив, каждый элемент которого - целое число больше нуля.display_name
null или непустая строка.entity_type
null или допустимый тип сущности (ключевое слово или строка).visibility_type
null или одно из:cruft
,hidden
,technical
.description
null или строка.caveats
null или строка.points_of_interest
null или строка.show_in_getting_started
логическое значение, может быть пустым.
PUT /api/table/:id
¶
Обновляет Table
по ID.
Параметры:¶
visibility_type
null или одно из:cruft
,hidden
,technical
.field_order
null или одно из:alphabetical
,custom
,database
,smart
.display_name
null или непустая строка.points_of_interest
null или строка.entity_type
null или допустимый тип сущности (ключевое слово или строка).description
null или строка.show_in_getting_started
логическое значение, может быть пустым.caveats
null или строка.id
PUT /api/table/:id/fields/order
¶
Изменяет порядок полей.
Параметры:¶
id
целое число больше нуля.field_order
последовательность значений должна состоять из целых чисел больше нуля.