OTRS API — это программный интерфейс (Application Programming Interface) для системы OTRS (Open-source Ticket Request System), которая сейчас известна как OTRS Community Edition и Znuny.
Основная суть OTRS API
Это механизм, который позволяет другим программам и системам взаимодействовать с OTRS без использования веб-интерфейса.
Простыми словами:
Представьте, что OTRS — это почтовое отделение, а API — это окно для юридических лиц, где можно:
· Отправлять пачки писем (создавать заявки)
· Получать информацию о письмах (читать заявки)
· Ставить отметки на письмах (изменять статусы)
· И всё это — без стояния в общей очереди (без веб-интерфейса)
Для чего используется OTRS API?
1. Интеграция с другими системами
· CRM системы могут создавать заявки в OTRS
· Системы мониторинга могут автоматически создавать инциденты
· Мобильные приложения для работы с заявками
2. Автоматизация процессов
python
# Пример: автоматическое создание заявки при сбое сервера
import requests
ticket_data = {
"Title": "Сбой сервера WEB-01",
"Queue": "IT",
"State": "new",
"Priority": "1 very high"
}
response = requests.post("https://otrs.example.com/api/tickets", json=ticket_data)
3. Массовые операции
· Импорт заявок из старой системы
· Выгрузка статистики для отчетов
· Массовое обновление данных клиентов
Как работает OTRS API?
Основные компоненты:
1. Generic Interface (Основной интерфейс)
o Принимает HTTP запросы (GET, POST, PUT, DELETE)
o Возвращает данные в формате JSON или XML
2. Конечные точки (endpoints)
text
/api/v1/tickets - работа с заявками
/api/v1/articles - работа с сообщениями
/api/v1/customers - работа с клиентами
/api/v1/queues - работа с очередями
Пример запроса:
bash
# Получение информации о заявке
GET /otrs/nph-genericinterface.pl/Webservice/GenericTicketConnector/Ticket/123
Authorization: SessionID abc123def456
# Ответ:
{
"Ticket": {
"TicketID": 123,
"TicketNumber": "202301150001",
"Title": "Проблема с принтером",
"State": "in progress",
"Queue": "Техподдержка"
}
}
Преимущества использования API
· Автоматизация — рутинные задачи выполняются программами
· Интеграция — объединение OTRS с другими системами компании
· Масштабируемость — обработка тысяч заявок без участия человека
· Гибкость — можно создать собственный интерфейс для специфических задач
Типичные сценарии использования
1. Веб-форма на сайте → Создание заявки в OTRS
2. Телефонный звонок → CRM создает заявку через API
3. Мониторинг оборудования → Автоматическое создание инцидентов
4. Мобильное приложение — Просмотр и обновление заявок
5. Биллинговая система — Открытие заявок по проблемам с оплатой
По сути, OTRS API превращает систему заявок из изолированного инструмента в центральный хаб для управления сервисами, который может взаимодействовать со всей IT-инфраструктурой организации.