Содержание
Серверная загрузка данных
Navigation
API отправки
api type: POST /api/v3/dataLoader/send //headers// Authorization: Bearer YOUR_TOKEN Content-Type: application/x-www-form-urlencoded //body// body : string(данные для отправки) dataSetId : string(id dataSet) updatePropertiesStrategy: replace (стратегия для объектов при отправке) // replace-заменяет объект; merge-объединяет объект; coordinates_merge-заменяет объект, без геокодирования. //return// возвращает id лога Корректная отправка { "status": 200, "message": "5d2*******d0c80", "code": 0 } Токен не корректен { "status": 400, "message": "Authorization error", "code": 0 } Не отправлен токен авторизации { "status": 403, "message": "Not logged in", "code": 0 }
API получения логов
Запрос логов осуществляется по ID, который был получен после отправки данных для загрузки. «userId»/«dataLoaderId» Указывается id либо пользователя если загрузка идёт напрямую пользователем, либо если загрузка идёт через dataLoader
id = logId format = json /api/v3/logs/get { "_id": string, //Уникальный идентификатор "createTime": unixtime, //Время загрузки данный в систему "startUploadTime": unixtime, //Время начала обработки данных "endUploadTime": unixtime, //Время окончания обработки данных "totalCount": int, //Общее количество объектов "successCount": int, //Количество успешно загруженных объектов "errorCount": int, //Количество неуспешно загруженных объектов "status": "wait" | "progress" | "success" | "error" | "successWithErrors" | "successWithWarnings" | "cancelled" | "geocoding", "message": string, "customer": { "id": string, "source": "user" | "dataLoader", "name": string } "dataSetId": string, "uniqueField": string | null, filesFromInput: string[], //Загруженные файлы filesFromStorage: string[], //Пути к загруженными файлам на сервере "objectErrors" : Array<{ "id" : string, "message" : string, "code" : int }> }
Создание модуля загрузки
1. Блок «Модуль загрузки» отвечает за создание нового модуля с указанием имени /api/dataLoader/create.
2. Блок «Дополнительные конфигурации». Данный блок содержит настройки места отправки «Хранилище данных\DataSet» и «Тип отправляемых данных». Можно выбрать «Устройства\location», «Статичные\Static». Формат данных для «Static» Описание формата загрузки и выгрузки , формат данных для location формат location.
3. Блоке «Список токенов» содержит в себе список доступных для заданного DataLoader-а токенов. При необходимости можно запросить новый токен указав имя для него.
4. Блок «Способ отправки данных» содержит форму запроса к API.
Коды ошибок
Ошибки загурзки
- 100 Системная ошибка
- 201 Не существуют геометрии для зависимого объекта
- 202 Не указаны координаты для точечного объекта
- 203 Превышена максимальная дистанция между объектами
- 204 Маленькая площадь полигона
- 301 Ошибка в линии, дублирование координат точек
- 302 Некорректная геометрия объекта
- 303 Недопустимый тип геометрии
- 304 Самопересечение полигона
- 401 Не указаны координаты
- 402 Тип геометрии не поддерживается
- 403 Некорректный тип геометрии для смешанных связей
- 404 Некорректный объект
- 405 Не заполнено обязательное поле
- 406 Не удалось построить барицентр
- 501 Найдена цикличная связь объектов
- 502 Некорректный тип связанного объекта
- 503 Недопустимая геометрия у связанного объекта
