TDG Documentation portal logo
Помощь
Обновлена 22 июня 2026 г. в 15:31

Вставка данных

Для вставки данных в TDG используются POST-запросы на адреса вида data/<TypeName>. Такие запросы эквивалентны вызовам repository.put c аналогичными аргументами.

Запрос

POST /data/<TypeName>?<arguments>
  • <TypeName> - имя типа данных из модели.
  • <arguments> - параметры запроса.

Запрос может содержать следующие параметры (все они являются опциональными):

version | Номер версии объекта для типов, поддерживающих версионирование. Значение по умолчанию: текущее значение временной метки Unix (Unix timestamp). Номер версии также можно передать в HTTP-заголовке version.

only_if_version | Для типов, поддерживающих версионирование: выполнить вставку, только если в хранилище есть переданный объект и номер его актуальной версии равен указанному значению. Значение по умолчанию: последняя хранимая версия.

Тело запроса для вставки объекта должно содержать описание этого объекта в формате JSON.

Если в хранилище уже существует объект с аналогичными значениями полей первичного индекса, в результате выполнения запроса он будет перезаписан.

Ответ

  • Если skip_result=false (по умолчанию): описание вставленного объекта в формате JSON.
  • Если skip_result=true: пустое тело ответа.

Пример

Запрос:

POST http://localhost:8081/data/City
{    "population": 3520031,    "title": "Berlin",    "capital": true,    "country":"Germany"}

Ответ:

{    "population": 3520031,    "title": "Berlin",    "capital": true,    "country":"Germany"}