Описание API

Пример обработки обращения к API из CURL на PHP

$host= 'http://localhost/api/requests/'; //запрос для каждой модели свой

$username = 'admin';

$password = 'admin';

$postFields = http_build_query(['service_id' => 3, 'CUsers_id' => 'admin', 'Status' => 'Открыта',

'ZayavCategory_id' => 'Заявканаобслуживание', 'Priority' => 'Низкий',

'Name' => 'Название', 'Content' => 'текст заявки']); //передается urlencoded POST-массив

$process = curl_init($host);

curl_setopt($process, CURLOPT_HEADER, 1);

curl_setopt($process, CURLOPT_USERPWD, $username . ":" . $password);

curl_setopt($process, CURLOPT_TIMEOUT, 30);

curl_setopt($process, CURLOPT_POST, 1);

curl_setopt($process, CURLOPT_POSTFIELDS, $postFields);

curl_setopt($process, CURLOPT_RETURNTRANSFER, TRUE);

$postFields = curl_exec($process);

curl_close($process);

Сущность заявки - таблица request:

Получение всех заявок

GET /api/requests/

Возвращает массив объектов Request

Получение заявок с выборкой

GET /api/requests/?Managers_id=manager (выборка заявок с определенным исполнителем, указывается логин);

GET /api/requests/?timestamp=2016-06-17 (выборка за определенную дату);

GET /api/requests/?timestamp=2016-06-17 10:00 (выборка за определенную дату и время);

GET /api/requests/?timestamp=>2016-06-17 10:00 (выборка за дату и время большую чем указана);

GET /api/requests/?service_id=3 (выборка по определенному сервису, id сервиса можно посмотреть в БД);

Возвращает массив объектов Request отфильтрованных по условию, поддерживаются значения = (равно), =<> (неравно), =< (меньше), => (больше).

Получение одной заявки

GET /api/requests/{id}

Возвращает объект Request по id

Создание новой заявки

POST /api/requests/

Для создания заявки необходимо передать объект Request

Редактирование заявки

PUT /api/requests/{id}

Для редактирования заявки по id, необходимо передать объект Request в JSON формате

Пример: {"Name":"TEST22","Content":"TEST55"}

Удаление заявки

DELETE /api/requests/{id}

Удаляет заявку по id

Получение записей истории заявки

GET /api/history/?zid={id}

Описание полей таблицы request доступных через API:

Сущность комментарии к заявке:

Создание нового комментария к заявке

POST /api/comments/

Для создания заявки необходимо передать объект Comment

Сущность вложения (файла) к заявке:

Создание нового вложения к заявке

POST /api/files/

Для создания заявки необходимо передать объект типа file

Возвращает объект file, в котором ID файла и URL файла.

При создании заявки можно передать массив загруженных ранее файлов files[]={id} с ID файлов.

Сущность проблемы - таблица problems:

Получение всех проблем

GET /api/problems/

Возвращает массив объектов Problem

Получение одной проблемы

GET /api/problems/{id}

Возвращает объект Problem по id

Создание новой проблемы

POST /api/problems/

Для создания проблемы необходимо передать объект Problem

Редактирование проблемы

PUT /api/problems/{id}

Для редактирования проблемы по id, необходимо передать объект Problem

Удаление проблемы

DELETE /api/problems/{id}

Удаляет проблемы по id

Описание полей таблицы problems доступных через API:

Сущность пользователь - таблица CUsers:

Получение списка пользователей

GET /api/users/

Возвращает массив объектов User

Получение одной пользователя

GET /api/users/{id}

Возвращает объект User по id

Создание нового пользователя

POST /api/users/

Для создания пользователя необходимо передать объект User

Редактирование пользователя

PUT /api/users/{id}

Для редактирования пользователя по id, необходимо передать объект User

Удаление пользователя

DELETE /api/users/{id}

Удаляет пользователя по id

Описание полей таблицы CUsers доступных через API:

Сущность актива - таблица assets:

Получение всех активов

GET /api/assets/

Возвращает массив объектовAsset

Получение одного актива

GET /api/assets/{id}

Возвращает объект Asset по id

Создание нового актива

POST /api/assets/

Для создания актива необходимо передать объектAsset

Редактирование актива

PUT /api/assets/{id}

Для редактирования актива по id, необходимо передать объект Asset

Удаление актива

DELETE /api/assets/{id}

Удаляет актив по id

Описание полей таблицы assets доступных через API:

Сущность КЕ - таблица cunits:

Получение всех КЕ

GET /api/cunits/

Возвращает массив объектов Cunit

Получение одной КЕ

GET /api/cunits/{id}

Возвращает объект Cunit по id

СозданиеновойКЕ

POST /api/cunits/

Для создания КЕ необходимо передать объект Cunit

Редактирование КЕ

PUT /api/cunits/{id}

Для редактирования КЕ по id, необходимо передать объект Cunit

УдалениеКЕ

DELETE /api/cunits/{id}

Удаляет КЕ по id

Описание полей таблицы cunits доступных через API:

Last updated