API – Імпорт оргструктури
Для авторизації використовуйте АРІ token. Детально в статті API token
Для імпорту оргструктури потрібно надіслати POST запит на URI/api/v2/orgstructure/import.
Імпорт оргструктури можна провести двома способами:
Імпорт за допомогою CSV-файлу
До запиту має бути прикріплений файл у форматі CSV наступного вигляду:
код підрозділу;назва підрозділу;код батьківського підрозділу a3123910441;підрозділ 1; a2567104662;підрозділ 1.2;a3123910441 a2701216083;підрозділ 1.2.1;a2567104662 a2206647782;підрозділ 1.2.2;a2567104662 a3123410541;підрозділ 2; a1468104662;підрозділ 2.1;a3123410541 a1206747582;підрозділ 2.1.2;a1468104662
Важливо: Код батьківського підрозділу має містити пусте значення! Не 0 або NULL.
Назви підрозділів оргструктури в файлі мають бути в тому порядку, в якому вони мають відображатися на порталі.
Назви підрозділів оргструктури в файлі мають бути в тому порядку, в якому вони мають відображатися на порталі.
- Запит повинен містити заголовки Content-Type: multipart/form-data та X-Cbr-Authorization: Bearer API_TOKEN.
Приклад запиту:
curl 'https://your-domain.davintoo.com/api/v2/orgstructure/import' -H 'X-Cbr-Authorization: Bearer API_TOKEN' -H 'Content-Type: multipart/form-data' -F 'file=@/path/to/structure.csv'
Замість локальної адреси https://your-domain.davintoo.com потрібно використовувати адресу вашого інстанса.
Імпорт оргструктури в JSON-форматі
Замість CSV-файлу в тіло запиту можна додати інформацію про оргструктуру в JSON-форматі, наприклад:
[
{
"uid": "structureid1",
"title": "structure1"
},
{
"uid": "departmentid2",
"parent_uid": "structureid1",
"title": "department2"
},
{
"uid": "departmentid3",
"parent_uid": "structureid1",
"title": "department3"
}
]
- Запит повинен містити заголовки Content-Type: application/json та X-Cbr-Authorization: Bearer API_TOKEN
- Налаштування body: raw, JSON
Приклад запиту:
`curl 'https://your-domain.davintoo.com/api/v2/orgstructure/import' -H 'X-Cbr-Authorization: Bearer API_TOKEN' -H 'Content-Type: application/json'
