Синхронизация документов (получение Id по OutLinkId)
- Dmitriy Maliuta (Unlicensed)
- Александр Киричок
Для синхронизации документов и справочников используется следующий механизм:
Все документы и справочники имеют уникальный идентификатор.
OutLinkID - уникальный идентификатор внешней системы;
Id - внутренний уникальный идентификатор TrackControl WEB;
API для работы с данными системы TrackControl WEB использует Id.
Для обращения к данным из внешней системы необходимо предварительно получить Id с помощью OutLinkId через нижеописанный запрос getID с параметрами table и массивом {OutLinkId}, где table - название справочника или таблицы документов, откуда получаются данные (список этих таблиц будет расширятся по мере разработки). После получения списка необходимых Id, можно выполнять все остальные запросы с использованием стандартного API TrackControl WEB.
Получение данных
Для получения списка OutLinkId необходимо отправить запрос GET на https://teletrack.ua/api/admin/getID/<token>/?Table=<Table>&OutLinkId=<OutLinkId,OutLinkId,OutLinkId>, где
| token | Токен, полученный при авторизации * |
| Table |
|
| OutLinkId | Внешний Id из сторонней системы * |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ со списком Id следующего формата:
{
"data": [
{
"Id": 92,
"OutLinkId": "cb04cd87-51f5-1"
},
{
"Id": 93,
"OutLinkId": "4e1d6e9f-6ed8-1"
}
],
"err": null,
"status": true
}
| Id | Полученный Id из БД |
Получение данных для таблицы "organizations"
Для получения списка Id по организациям с указанием параметра Level, необходимо отправить запрос GET на https://teletrack.ua/api/admin/getID/<token>/?Table=organizations&OutLinkId=<OutLinkId>,<OutLinkId>, где
| token | Токен, полученный при авторизации * |
| OutLinkId | Внешний Id из сторонней системы |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ со списком Id следующего формата:
{
"data": [
{
"Id": 22,
"Level": 2,
"OutLinkId": "567TT"
},
{
"Id": 24,
"Level": 1,
"OutLinkId": "222"
}
],
"err": null,
"status": true
}
| Id | Полученный Id из БД |
| Level | Параметр организации: 1 - организация 2 - управляющая организация |
| OutLinkId | Внешний Id из сторонней системы |