Это старая версия документа!
Серверная загрузка данных
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)
//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" | "error" | "success"
"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.
Коды ошибок
Ошибки загурзки
1 Invalid dataSet id
2 File not parsed
3 Icon not updated
4 Data set log not found
5 Invalid DataSet Type
6 Save error
Import data
101 Invalid input data
102 Invalid feature
103 Object not delete. Unique field not set
104 Object not delete. Object not found
105 Coordinates must be is numeric
relation
201 Relation properties not exists
202 Geometry cannot be built. Relation coordinates not exists
203 Relation geometryType not exists
204 Relation has no members
member
300 Member not found. Id
301 Node not found
302 Way not found
303 Invalid member type
304 One relation members expected for polygon
305 Three or more node members expected for polygon
306 Impossible to build the geometry of different types
307 One and more relation member is expected for a multi point
308 Master feature for dependent dataset not found
309 One relation member is expected for Point
geometry
400 Relation not found
401 Impossible merge two types of geometry
402 Impossible convert type of geometry
403 Invalid geometry, is not array
404 Invalid geometry, coordinates must contain one pair/triplet of coordinates
405 Invalid geometry, incorrect longitude value
405 Invalid geometry, incorrect latitude value
406 Invalid geometry, the lineString must consist of 2 or more points
407 Invalid geometry, duplicate points in line
408 Invalid geometry, the polygon must consist of 4 or more points
409 Invalid geometry, the polygon is not closed
410 Invalid geometry, the polygon must consist at least one LinearRing
411 Invalid geometry, the LinearRing must consist of 3 or more Points
412 Invalid geometry, the MultiLineSting must consist of 1 or more Lines
413 Invalid geometry, the MultiPoint must consist of 1 or more Points
414 Invalid geometry, the MultiPolygon must consist of 1 or more Polygons
415 Invalid geometry, the MultiPolygon has self intersection
416 Invalid geometry, the Bbox must consist of 1 or more coordinates
417 Nested GeometryCollection is not supported
418 Polygon crosses itself
419 Invalid geometry type
420 Empty geometry coordinates
421 Exceeded the maximum length
422 Invalid update properties strategy
423 Invalid geometry type for combining
424 Empty geometry geometries