Вставка данных¶
Для вставки данных в TDG используются POST-запросы на адреса вида data/<TypeName>.
Такие запросы эквивалентны вызовам repository.put c аналогичными аргументами.
Запрос¶
POST /data/<TypeName>?<arguments>
<TypeName>– имя типа данных из модели.<arguments>– параметры запроса.
Запрос может содержать следующие параметры (все они являются опциональными):
|
Номер версии объекта для типов, поддерживающих версионирование. Значение по умолчанию: текущее значение временной метки Unix (Unix timestamp). Номер версии также можно передать в HTTP-заголовке |
|
Для типов, поддерживающих версионирование: выполнить вставку, только если в хранилище есть переданный объект и номер его актуальной версии равен указанному значению. Значение по умолчанию: последняя хранимая версия. |
|
Флаг выполнения запроса без возврата вставленного объекта.
Значение по умолчанию: |
Тело запроса для вставки объекта должно содержать описание этого объекта в формате 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"
}