datasource api v2

Author: wulff007

Diff for: ru/api/datasource-v2.md

@@ -2,7 +2,7 @@
 
 ## Конфигурация
 
-### Получение одного по алиасу
+### Получение настроек источника данных по алиасу
 
 Метод: GET /v2/datasource/:alias
 
@@ -15,7 +15,7 @@
 * item (DataSourceConfigDto, required) - параметры источника данных
 
 
-### Получение списка
+### Получение списка источников данных
 
 Метод: GET /v2/datasource
 
@@ -25,7 +25,7 @@
 * items (DataSourceConfigDto[], required) - список источников данных
 
 
-### Создание
+### Создание источника данных
 **Метод**: POST /v2/datasource
 
 Создает новый источник данных по указанным настройкам
@@ -38,10 +38,10 @@
 
 * success (bool, required) - успешность запроса,
 * errors (Error[], optional, если success = false) - список возникших ошибок,
-* data (object, optional) 
+* data (object, optional) - данные по созданному источнику данных 
   * id (string, required) - идентификатор созданного источника данных
 
-### Изменение
+### Изменение источника данных по алиасу
 
 Перезаписывает настройки по алиасу
 
@@ -59,7 +59,7 @@
 * data (object, optional)
     * id (string, required) - идентификатор измененного источника данных
 
-### Обновление параметров настроек
+### Обновление параметров настроек по алиасу
 
 Обновляет по алиасу настройки которые были переданы, те которые не переданы оставляет в исходном виде
 
@@ -107,6 +107,55 @@
 * count (int, required) - кол-во записей в выборке
 
 
+### Получение записи по идентификатору
+
+Метод: GET /v2/datasource/:alias/data/:itemId
+
+Параметры:
+* :alias - алиас источника данных
+* :itemId - идентификатор записи
+* fields - список полей, которые необходимо включить, если не указан, то все поля, включая системные
+
+Параметры тела ответа
+
+* success (bool, required) - успешность запроса,
+* item (object, required) - данные записи
+  * ... все поля записи или только указанные поля в запросе
+
+### Получение список изменений записи по идентификатору записи
+
+Метод: GET /v2/datasource/:alias/data/:itemId/revisions
+
+Параметры запроса:
+* :alias - алиас источника данных
+* :itemId - идентификатор записи
+
+Параметры ответа: 
+
+* success (bool, required) - успешность запроса,
+* items (object, required) - данные записи
+    * id (string, required) - ид истории изменения
+    * version - версия
+    * createdBy (string, required) - ид пользователя внесшего изменения
+    * createdAt (timestamp, required) - дата и время внесения изменения
+
+
+### Получение изменения записи по идентификатору записи и ид изменения
+
+Метод: GET /v2/datasource/:alias/data/:itemId/revisions/:revId
+
+Параметры запроса:
+* :alias - алиас источника данных
+* :itemId - идентификатор записи
+* :revId - идентификатор изменения
+
+Параметры ответа:
+
+* success (bool, required) - успешность запроса,
+* item (object, required) - все данные записи истории изменения
+* revisionId - идентификатор изменения
+* version - версия
+
 
 
 # Структура объектов