STN REST API
Краткое описание методов
| Номер | Метод | Описание |
|---|---|---|
| 1 | GET /assistants/version | Возвращает версию сервиса Ассистент. |
| 2 | GET /assistants/status | Проверяет статус доступности сервиса Ассистент. |
| 3 | POST /assistants/answer | Сохраняет контекст ответа на поисковой запрос пользователя, затем на их основе формирует ответ пользователю. |
| 4 | GET /reltype/version | Возвращает версию сервиса определения типа связи. |
| 5 | POST /reltype/tasks | Создаёт задачу на определение типа связи. |
| 6 | GET /reltype/gettasks | Получает результат задачи на определение типа связи. |
| 7 | POST /reltype/classify | Определяет тип связи без создания задачи. |
| 8 | DELETE /reltype/deletetasks | Удаляет задачу на определение типа связи. |
| 9 | GET /semanalysis/version | Возвращает версию севиса семантического анализа. |
| 10 | POST /semanalysis/documentsearch | Выявляет содержательные пересечения текстовых фрагментов документов для определения пересекающихся между собой документов. |
| 11 | GET /archive/version | Возвращает версию сервиса хранения. |
| 12 | POST /archive/QueryGetList | Получает информацию о запросах в определённом индексе. |
| 13 | POST /archive/favoritesQueryGetList | Получает информацию по избранным запросам в определённом индексе. |
| 14 | POST /archive/favoritesQueryAdd | Добавляет избранный запрос. |
| 15 | POST /archive/favoritesQueryDelete | Удаляет избранный запрос. |
| 16 | POST /archive/archiveGetList | Получает информацию о просмотренных документах пользователя. |
| 17 | POST /archive/favoritesArchiveGetList | Получает список избранных документов. |
| 18 | POST /archive/favoritesArchiveAdd | Добавляет документ в избранное. |
| 19 | POST /archive/favoritesArchiveDelete | Удаляет документ из избранного. |
| 20 | GET /ais/version | Возвращает версию Content AI Intelligent Search. |
| 21 | GET /ais/status | Получает информацию об основных настройках Intelligent Search. |
| 22 | GET /ais/indexes | Получает информацию о списке индексов Content AI Intelligent Search. |
| 23 | GET /ais/indexes/indexName | Получает информацию о конкретном индексе Content AI Intelligent Search. |
| 24 | GET /ais/search | Задействует поиск Intelligent Service. |
| 25 | GET /ais/Suggestions | Возвращает подсказки в ответ на запрос. |
| 26 | GET /ais/getFile | Возвращает бинарный файл. |
| 27 | GET /info/version | Возвращает версию ProxyBack. |
Краткое описание методов Configuration service
| Номер | Метод | Описание |
|---|---|---|
| 28 | GET /version | Возвращает версию сервиса конфигурации. |
| 29 | GET /parameters/front | Получение публичного списка параметров. |
| 30 | GET /parametrs | Возвращает список всех параметров. |
| 31 | GET /parameters/public | Возвращает ограниченный список параметров, используемый при первоначальной загрузке. |
| 32 | PUT /parameters | Позволяет редактировать список параметров. |
| 33 | GET /parameter | Позволяет редактировать отдельный параметр. |
| 34 | GET /parameter/id | Возвращает значение конкретного параметра по идентификатору. |
| 35 | GET /types | Получить список типов приложений. |
1. Получение информации о версии сервиса Ассистент
Данный метод возвращает версию сервиса Ассистент
URL
http://server:8095/
Метод
GET /assistants/version
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
"1.0.8"
2. Получение информации о сервисе Ассистент
Данный метод проверяет статус доступности сервиса Ассистент.
URL
http://server:8095/
Метод
GET /assistants/status
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
"Assistant 1.0.8 is running"
3. Вызов сервиса Ассистент
Данный метод сохраняет контекст ответа на поисковой запрос пользователя, затем на их основе формирует ответ пользователю.
URL
http://server:8095/
Метод
POST /assistants/answer
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| guid | string | Guid входного запроса поиска для получения результатов из кеша. Может быть пустым. Используется для снижения нагрузки на поиск. | - |
| indexName | string | Наименование индекса, в котором необходимо осуществить поиск. | Из параметров сервера. |
| getContext | boolean | Возвращать ли контекст, отправляемый в сервис Ассистента? | false |
Тело запроса
{
"query": "string",
"userQuery": "string",
"isSuggest": true,
"resultFields": [
"string"
],
"count": 0,
"from": 0,
"hlFields": [
"string"
],
"id": "string",
"position": 0,
"__acl": [
"string"
],
"defaultSearchFields": [
"string"
],
"facets": [
"string"
],
"searchFieldsBoost": {
"additionalProp1": 0,
"additionalProp2": 0,
"additionalProp3": 0
},
"sort": [
"string"
],
"flags": [
"string"
],
"problemCode": "string",
"problemDescription": "string",
"siteUrl": "string",
"subscribe": true,
"reportDocumentId": "string",
"queryAnalysisTime": 0,
"description": "string",
"availableHits": 0,
"totalHits": 0,
"totalSearchTime": 0,
"flagAddedResultsByQuery": true
}
Описание параметров тела запроса находится в руководстве по интеграции Content AI Intelligent Search.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
string
{
"totalHits": 1,
"resultList": [
{
"id": 364,
"date": "2025-03-13T14:33:36.7596Z",
"user": "Сергей Иванов",
"index":{
"answer": "Автомат — это стрелковое оружие, принятое на вооружение в СССР в 1949 году и разработанное Михаилом Тимофеевичем Калашниковым. Этот автомат, известный как АК-47, использует патрон 7,62 × 39 мм [2].",
"used_context_ids": [
0,
1,
2,
3,
4
],
"source_decoding": {
"1": "g2MWsJMBnML2wHXBUoKc",
"2": "J2Pkr5MBnML2wHXBeIJX",
"3": "O2Pnr5MBnML2wHXB1IIG",
"4": "SWPwr5MBnML2wHXBPIIZ"
},
"fileMapping": [
{
"index": 0,
"id": "J2Pkr5MBnML2wHXBeIJX",
"name": "Автомат Калашникова.pdf"
},
{
"index": 1,
"id": "J2Pkr5MBnML2wHXBeIJX",
"name": "Автомат Калашникова.pdf"
},
{
"index": 2,
"id": "J2Pkr5MBnML2wHXBeIJX",
"name": "Автомат Калашникова.pdf"
},
{
"index": 3,
"id": "O2Pnr5MBnML2wHXB1IIG",
"name": "Гослинг, Райан.pdf"
},
{
"index": 4,
"id": "SWPwr5MBnML2wHXBPIIZ",
"name": "Жириновский, Владимир Вольфович.pdf"
},
{
"index": 5,
"id": "g2MWsJMBnML2wHXBUoKc",
"name": "Сталинградская битва.pdf"
}
]
} "wiki",
"fileId": "J2Pkr5MBnML2wHXBeIJX",
"fileName": "Автомат Калашникова.pdf",
"location": "/mnt/SearchStorageTest/wiki/Автомат Калашникова.pdf",
"isDeleted": false
},
]
}
4. Получение информации о версии сервиса определения типа связи
Данный метод возвращает версию сервиса определения типа связи
URL
http://server:8095/
Метод
GET /reltype/version
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
"1.0.1"
5. Создать задачу на определение типа связи
Данный метод создаёт задачу на определение типа связи.
URL
http://server:8095/
Метод
POST /reltype/tasks
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"query_text": "string",
"found_text": "string",
"threshold": 0,
"uid": "string"
}
П р и м е ч а н и я
- Между query_text и found_text метод устанавливает логическую связь, возвращая одно из значений в параметр result: дублирование (entailment), противоречие (contradiction) или нейтральная (neutral).
- Параметр threshold - критерий выделения кандидатов на выделение связи. Чем выше значение, тем меньше вероятность получения связи, отличной от нейтральной.
- Параметр uid – идентификатор пользователя, предназначен для удаления задач разлогинившегося пользователя.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
{
"query_text": "Расстояние равно 10",
"found_text": "Расстояние равно 20",
"threshold": 0,
"uid": "string",
"id": "01JBGXKXNQC1RMMCV6RPZ0T3DE",
"status": "PENDING",
"result": null,
"detail": null
}
П р и м е ч а н и я
- Параметр status показывает статус задачи по определению типа связи.
- Параметр result содержит результат определения типа связи. Если он равен null, то нужно воспользоваться методом получения задачи по определение типа связи.
- Параметр detail возвращает информацию об ошибке в обработке задачи, если задача выполнена успешно, то возвращает null.
6. Получить задачу по определение типа связи
Данный метод получает результат задачи на определение типа связи.
URL
http://server:8095/
Метод
GET /reltype/gettasks
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| taskId | string | ID задачи, которое возвращается при создании задачи. | - |
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
string JSON
{
"query_text": "Расстояние равно 10",
"found_text": "Расстояние равно 20",
"threshold": 0,
"uid": "string",
"id": "01JBGXKXNQC1RMMCV6RPZ0T3DE",
"status": "COMPLETED",
"result": "contradiction",
"detail": null
}
П р и м е ч а н и я
- Параметр status показывает статус задачи по определению типа связи.
- Параметр result содержит результат определения типа связи. Если он равен null, то нужно воспользоваться методом получения задачи по определение типа связи.
- Параметр detail возвращает информацию об ошибке в обработке задачи, если задача выполнена успешно, то возвращается null.
7. Определить тип связи
Данный метод определяет тип связи без создания задачи.
URL
http://server:8095/
Метод
POST /reltype/classify
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"query_text": "string",
"found_text": "string",
"threshold": 0,
"uid": "string"
}
П р и м е ч а н и я
- Между query_text и found_text метод устанавливает логическую связь, возвращая одно из значений: дублирование (entailment), противоречие (contradiction) или нейтральная (neutral).
- Параметр threshold - критерий выделения кандидатов на выделение связи. Чем выше значение, тем меньше вероятность получения связи, отличной от нейтральной.
- Параметр uid – идентификатор пользователя, предназначен для удаления задач разлогинившегося пользователя.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
string
neutral
8. Удалить задачу по определение типа связи
Данный метод удаляет задачу на определение типа связи.
URL
http://server:8095/
Метод
DELETE /reltype/deletetasks
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| uid | string | ID задачи, которое возвращается при создании задачи. | - |
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
{
"detail": "Deleted 0 tasks with uid: \"01JBGXKXNQC1RMMCV6RPZ0T3DE\""
}
П р и м е ч а н и е
Параметр detail содержит информацию о статусе удаления задачи на определение типа связи.
9. Получение информации о версии сервиса семантического анализа
Данный метод возвращает текущую версию сервиса семантического анализа.
URL
http://server:8095/
Метод
GET /semanalysis/version
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
"1.1.0"
10. Найти похожие документы
Данный метод выявляет содержательные пересечения текстовых фрагментов документов для определения пересекающихся между собой документов.
URL
http://server:8095/
Метод
POST /semanalysis/documentsearch
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| indexName | string | Наименование индекса, в котором надо осуществить поиск. | Указано в переменной DEFAULT_INDEX. |
Тело запроса
{
"input": "string",
"filters": "string",
"resultFields": [
"string"
],
"facets": [
{
"facetName": "string",
"includeFilter": "string",
"sortBy": "string",
"sortOrder": "string"
}
],
"percentageOfSimilarity": 0,
"percentageDocsContains": 0,
"topDocsToTake": 0
}
П р и м е ч а н и е
Описание параметров тела запроса находится в руководстве по интеграции Content AI Intelligent Search.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
"documents": [{
"id": "7N4zGpMBZOHCaQmiiKrX",
"relevance": 2047.1089,
"body": "<em>\nСписок президентов США</em>\n\nБелый дом, официальная резиденция президента США и центр его администрации\n\nПрезидент США — глава исполнительной власти и государства США. Должность введена Конституцией США[1], принятой Конституционным конвентом (собранием) в 1787 году. Первым президентом США стал в 1789 году Джордж Вашингтон.",
"ranges": [{
"start": 0,
"end": 23
}, {
"start": 1845,
"end": 1864
}
],
"count": 1,
"resultFields": {
"createdDate": "2024-07-02T17:46:28.000+03:00",
"filename": "Список президентов США.pdf",
"__date_enriched": "2024-11-11T10:50:05.000+03:00",
"__date_indexed": "2024-11-21T13:42:47.000+03:00",
"__location": "/mnt/SearchStorageTest/tuser/Список президентов США.pdf",
"creator": "Гаврилова Ева Макаровна",
"extension": "pdf",
"__date": "2024-07-02T17:46:28.000+03:00",
"__duplicates": "JAoJV87tTo",
"__languages": ["ru-RU"],
"__sourceName": "FileSystem"
}
}
],
"facets": {
"sourceNameFacet": [{
"value": "FileSystem",
"count": 1
}
],
"creatorFacet": [{
"value": "Гаврилова Ева Макаровна",
"count": 1
}
],
"extensionFacet": [{
"value": "pdf",
"count": 1
}
],
"modifiedFacet": [{
"value": "2024.07",
"count": 1
}
],
"languageFacet": [{
"value": "ru-RU",
"count": 1
}
]
}
}
П р и м е ч а н и я
- Параметр id возвращает идентификатор документа.
- Параметр relevance получается сложением параметра score у найденных документов. Чем выше значение, тем выше релевантность.
- Параметр body возвращает текст документа, в котором найденные вхождения выделены тегом em.
- Параметры start и end у параметра ranges возвращают позиции найденных подстрок.
- Параметр count возвращает число найденных документов.
- Описание параметров, входящих в resultFields, находится в руководстве по интеграции Content AI Intelligent Search.
- Параметры value и count у параметра sourceNameFacet возвращают имя источника, из которого получены документы, и количество документов в этом источнике.
- Параметры value и count у параметра creatorFacet возвращают имя создателя документов, и количество документов, созданных им.
- Параметры value и count у параметра extensionFacet возвращают расширение документов, и количество документов с таким расширением.
- Параметры value и count у параметра modifiedFacet возвращают дату документов, и количество документов с такой датой.
- Параметры value и count у параметра languageFacet возвращают язык документов, и количество документов с таким языком.
11. Получение информации о версии сервиса хранения
Данный метод возвращает версию сервиса хранения
URL
http://server:8095/
Метод
GET /archive/version
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
{
"ApplicationName":"Searchaiservicearchive",
"ApplicationVersion":"1.0.3"
}
12. Информация о выбранных запросах
Данный метод получает информацию о запросах в определённом индексе.
URL
http://server:8095/
Метод
POST /archive/QueryGetList
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"index": "string",
"count": 0,
"from": 0
}
П р и м е ч а н и я
- Параметр index заполняется названием индекса.
- Параметр count заполняется числом, равным количеству запросов, которые нужно получить.
- Параметр from заполняется числом, равным порядковому номеру запроса, начиная с которого нужно получить выбранные запросы.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
[{"id":13468,"date":"2024-11-01T12:37:28.306481Z","user":"TUser user","index":"gost","query":"СТО 2022"},
{"id":13467,"date":"2024-11-01T12:36:14.921582Z","user":"TUser user","index":"gost","query":"трубопровод"}]
П р и м е ч а н и я
- Параметр id заполняется идентификатором запроса, удовлетворяющего параметрам отбора.
- Параметр date заполняется датой создания запроса.
- Параметр user заполняется логином пользователя, выполнившего запрос.
- Параметр index заполняется названием индекса.
- Параметр query заполняется содержимым запроса.
13. Список избранных запросов
Данный метод получает информацию по избранным запросам в определённом индексе для пользователя, под которым авторизована текущая сессия.
URL
http://server:8095/
Метод
POST /archive/favoritesQueryGetList
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"index": "string",
"count": 0,
"from": 0
}
П р и м е ч а н и я
- Параметр index заполняется названием индекса.
- Параметр count заполняется числом, равным количеству избранных запросов, которые нужно получить.
- Параметр from заполняется числом, равным порядковому номеру избранного запроса, начиная с которого нужно получить выбранные запросы.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
{
"id": 78,
"date": "2024-10-15T07:39:14.894997Z",
"user": "TUser user",
"index": "gost",
"query": "сжигание топлива"
}
П р и м е ч а н и я
- Параметр id заполняется идентификатором избранного запроса.
- Параметр date заполняется датой добавления запроса в избранное.
- Параметр user заполняется логином пользователя, выполнившего запрос.
- Параметр index заполняется названием индекса.
- Параметр query заполняется содержимым запроса.
14. Добавить избранный запрос
Данный метод добавляет избранный запрос запрос для пользователя, под которым авторизована текущая сессия.
URL
http://server:8095/
Метод
POST /archive/favoritesQueryAdd
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"index": "string",
"query": "string"
}
П р и м е ч а н и я
- Параметр index заполняется названием индекса.
- Параметр query заполняется текстом избранного запроса, который нужно добавить.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
string
"ok"
15. Удалить избранный запрос
Данный метод удаляет избранный запрос для пользователя, под которым авторизована текущая сессия.
URL
http://server:8095/
Метод
POST /archive/favoritesQueryDelete
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| id | string | Идентификатор избранного запроса, который можно получить запросом информации о всех запросах. | - |
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
string
"ok"
16. Информация о просмотренных документах
Данный метод получает информацию о просмотренных документах пользователя, под которым авторизована текущая сессия.
URL
http://server:8095/
Метод
POST /archive/archiveGetList
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"index": "string",
"count": 0,
"from": 0
}
П р и м е ч а н и я
- Параметр index заполняется названием индекса.
- Параметр count заполняется числом, равным количеству просмотренных документов, которые нужно получить.
- Параметр from заполняется числом, равным порядковому номеру просмотренного документа, начиная с которого нужно получить выбранные просмотренные документы.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
{
"totalHits": 1,
"resultList": [
{
"id": 364,
"date": "2025-03-13T14:33:36.7596Z",
"user": "Сергей Иванов",
"index": "wiki",
"fileId": "J2Pkr5MBnML2wHXBeIJX",
"fileName": "Автомат Калашникова.pdf",
"location": "/mnt/SearchStorageTest/wiki/Автомат Калашникова.pdf",
"isDeleted": false
},
]
}
17. Список избранных документов
Данный метод получает список избранных документов пользователя, под которым авторизована текущая сессия.
URL
http://server:8095/
Метод
POST /archive/favoritesArchiveGetList
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"index": "string",
"count": 0,
"from": 0
}
П р и м е ч а н и я
- Параметр index заполняется названием индекса.
- Параметр count заполняется числом, равным количеству избранных документов, которые нужно получить.
- Параметр from заполняется числом, равным порядковому номеру избранного документа, начиная с которого нужно получить выбранные избранные документы.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
{
"id": 150,
"date": "2024-10-31T14:52:58.100975Z",
"user": "TUser user",
"index": "gost",
"fileId": "kjrR15IB8N7zHhoteQQg",
"fileName": "2",
"location": "/mnt/SearchStorageTest/Moscow/2.pptx",
"isDeleted": false
}
П р и м е ч а н и я
- Параметр id возвращает идентификатор избранного документа.
- Параметр date возвращает дату добавления избранного документа.
- Параметр user возвращает имя пользователя, добавившего избранный документ.
- Параметр index возвращает название индекса, содержащего избранный документ.
- Параметр fileId возвращает идентификатор файла избранного документа.
- Параметр fileName возвращает название файла избранного документа.
- Параметр location возвращает местоположение файла избранного документа.
- Параметр isDeleted возвращает признак удаления файла.
18. Добавить избранный документ
Данный метод добавляет документ в Избранное для пользователя, под которым авторизована текущая сессия.
URL
http://server:8095/
Метод
POST /archive/favoritesArchiveAdd
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"index": "string",
"fileId": "string",
"fileName": "string",
"location": "string",
"isDeleted": true
}
П р и м е ч а н и я
- Параметр index заполняется названием индекса.
- Параметр fileId заполняется идентификатором файла.
- Параметр fileName заполняется именем файла.
- Параметр location заполняется путём к файлу.
- Параметр isDeleted заполнять true.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
string
"ok"
19. Удалить избранный документ
Данный метод удаляет документ из Избранного для пользователя, под которым авторизована текущая сессия.
URL
http://server:8095/
Метод
POST /archive/favoritesArchiveDelete
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| id | string | Идентификатор удаляемого избранного документа | - |
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
string
"ok"
20. Получение информации о версии Content AI Intelligent Search
Данный метод возвращает версию Content AI Intelligent Search
URL
http://server:8095/
Метод
GET /ais/version
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
{
"product": {
"name": "Content AI Intelligent Search",
"version": "5.7.0.2-linux",
"date": "2024-05-19"
},
"components": [
{
"name": "Elastic",
"version": "7.5.1"
}
],
"OS": {
"name": "Linux",
"version": "5.15.0-125-generic"
},
"license": {
"expirationDate": "2025-06-30T00:00:00",
"searchIndexDocsCount": 2000,
"searchUsersCount": 25,
"searchActiveUsersCount": 3,
"expirationTime": "2025-06-30T00:00:00"
}
}
21. Информация об основных настройках Intelligent Search
Данный метод получает информацию об основных настройках Intelligent Search.
URL
http://server:8095/
Метод
GET /ais/status
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
[
{
"index": "gost",
"sources": [
{
"sourceName": "FileSystem",
"crawlingStatus": "completed",
"crawlStartTime": "2025-04-10T10:22:28+03:00",
"crawlFinishTime": "2025-04-10T10:22:34+03:00",
"lastCrawlTotalTime": "0s",
"crawlingNode": "st-ubuntu-02",
"docsCrawled": 16,
"docsCrawledNew": 0,
"docsSkipped": 0,
"docsDeleted": 0,
"crawlingErrors": 0,
"docsProcessedSuccessfully": 0,
"docsProcessedWithErrors": 0,
"docsProcessingFailed": 0,
"docsIndexedSuccessfully": 0,
"docsIndexingFailed": 0,
"nextCrawlTime": "2025-04-11T10:22:28+03:00"
}
]
},
{
"index": "wiki",
"sources": [
{
"sourceName": "FileSystem",
"crawlingStatus": "completed",
"crawlStartTime": "2025-04-10T10:31:59+03:00",
"crawlFinishTime": "2025-04-10T10:32:05+03:00",
"lastCrawlTotalTime": "0s",
"crawlingNode": "st-ubuntu-02",
"docsCrawled": 116,
"docsCrawledNew": 0,
"docsSkipped": 1,
"docsDeleted": 0,
"crawlingErrors": 0,
"docsProcessedSuccessfully": 0,
"docsProcessedWithErrors": 0,
"docsProcessingFailed": 0,
"docsIndexedSuccessfully": 0,
"docsIndexingFailed": 0,
"nextCrawlTime": "2025-04-11T10:32:59+03:00"
}
]
П р и м е ч а н и е
Описание параметров тела ответа находится в руководстве по интеграции Content AI Intelligent Search.
22. Информация о списке индексов
Данный метод получает список индексов Intelligent Search.
URL
http://server:8095/
Метод
GET /ais/indexes
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
[
{
"index": "wiki"
},
{
"index": "gost"
}
]
23. Получение информации о конкретном индексе Content AI Intelligent Search.
Данный метод получает информацию о конкретном выбранном индексе.
URL
http://server:8095/
Метод
GET /ais/indexes/indexName
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| indexName | string | Наименование индекса, в котором необходимо осуществить поиск. | Указано в переменной DEFAULT_INDEX. |
Тело запроса
{
"index": "gost",
"fields": [
{
"field": "body",
"type": "String",
"indexType": "Semantic",
"sorted": false,
"isArray": false,
"updateUsingRegex": [],
"similarSearch": {
"enabled": true
},
"promotedResults": {
"enabled": false
},
"synonyms": {
"enabled": true,
"applyWhileIndexing": false,
"dictionaries": []
},
"characterNormalization": {
"enabled": false
},
"queryCorrection": {
"enabled": true,
"useAsSource": true,
"maxTokensCount": 300
},
"urlDecoding": {
"enabled": false
},
"addHyperlinks": [
{
"order": 1,
"addLinksOn": "Synonyms"
}
],
"systemField": false
}]
}
П р и м е ч а н и е
Описание параметров тела запроса находится в руководстве по интеграции Content AI Intelligent Search.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
[{}]
24. Поиск Intelligent Search
Данный метод задействует поиск Intelligent Service.
URL
http://server:8095/
Метод
GET /ais/search
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| indexName | string | Имя индекса | Указано в переменной DEFAULT_INDEX. |
Тело запроса
{
"query": "string",
"userQuery": "string",
"isSuggest": true,
"resultFields": [
"string"
],
"count": 0,
"from": 0,
"hlFields": [
"string"
],
"id": "string",
"position": 0,
"__acl": [
"string"
],
"defaultSearchFields": [
"string"
],
"facets": [
"string"
],
"searchFieldsBoost": {
"additionalProp1": 0,
"additionalProp2": 0,
"additionalProp3": 0
},
"sort": [
"string"
],
"flags": [
"string"
],
"problemCode": "string",
"problemDescription": "string",
"siteUrl": "string",
"subscribe": true,
"reportDocumentId": "string",
"queryAnalysisTime": 0,
"description": "string",
"availableHits": 0,
"totalHits": 0,
"totalSearchTime": 0,
"flagAddedResultsByQuery": true
}
П р и м е ч а н и е
Детальное описание параметров тела запроса смотрите в Content AI Intelligent Search - Руководство по интеграции.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
{
"totalSearchTime": 65,
"queryAnalysisTime": 4,
"indexSearchTime": 61,
"totalHits": 1,
"availableHits": 1,
"hits": [
{
"relevance": 19777.47,
"id": "5Dow2JIB8N7zHhot0gV_",
"resultFields": {
"createdDate": "2022-08-19T10:23:47+03:00",
"filename": "СТО ИНТИ S.10.3-2022 Rus.pdf",
"__date_enriched": "2024-10-29T15:12:11+03:00",
"__date_indexed": "2024-10-29T15:12:11+03:00",
"__location": "/mnt/SearchStorageTest/Moscow/СТО ИНТИ S.10.3-2022 Rus.pdf",
"creator": "Рогозов Алексей Алексеевич",
"extension": "pdf",
"__date": "2024-09-27T11:42:25.323+03:00",
"__duplicates": "dll7N9736Y",
"__languages": [
"ru-RU"
],
"__sourceName": "FileSystem"
},
"hlFields": {
"body": [
"Общие технические условия<em>СТО ИНТИ S.10.3-2022</em> Издание официальное. Лист данных дозировочных насосов<em>СТО ИНТИ S.10.3-2022</em>
]
}
}
],
"facets": {
"lastAuthorFacet": [],
"sourceNameFacet": [
{
"value": "FileSystem",
"count": 1
}
],
"modifiedFacet": [
{
"value": "2024.09",
"count": 1
}
],
"languageFacet": [
{
"value": "ru-RU",
"count": 1
}
],
"extensionFacet": [
{
"value": "pdf",
"count": 1
}
],
"creatorFacet": [
{
"value": "Рогозов Алексей Алексеевич",
"count": 1
}
]
},
"guid": "315579f0-751b-42a8-b932-67d8d63cc86a"
}
П р и м е ч а н и е
Описание параметров тела ответа находится в руководстве по интеграции Content AI Intelligent Search.
25. Отображение подсказок при вводе запроса
Данный метод возвращает подсказки в ответ на запрос.
URL
http://server:8095/
Метод
GET /ais/Suggestions
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| indexName | string | Имя индекса | Указано в переменной DEFAULT_INDEX. |
Тело запроса
{
"query": "string",
"maxCount": 0
}
П р и м е ч а н и я
- Параметр query заполняется текстом запроса, к которому нужны подсказки.
- Параметр maxCount заполняется числом, ограничивающим максимальное количество подсказок.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
JSON
{
"totalSearchTime": 7,
"suggestions": [
{
"query": "какой диаметр условного прохода у стальных <em>труб?</em>",
"count": 315,
"source": "searchQuery"
}
]
}
П р и м е ч а н и е
Описание параметров тела ответа находится в руководстве по интеграции Content AI Intelligent Search.
26. Скачивание файла
Данный метод возвращает бинарный файл.
URL
http://server:8095/
Метод
GET /ais/getFile
Параметры
| Имя | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| docId | string | Идентификатор файла Intelligent Search | - |
| fileName | string | Имя файла для скачивания с расширением | file |
| indexName | string | Наименование индекса | Указано в переменной DEFAULT_INDEX. |
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Тип файла
- Пример
200
Успешный ответ
binary
27. Получение информации о версии ProxyBack
Данный метод возвращает версию ProxyBack
URL
http://server:8095/
Метод
GET /info/version
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
{
"ApplicationName": "Searchaiservice",
"ApplicationVersion": "1.0.3"
}
28. Получение информации о версии Configuration service
Данный метод возвращает версию Configuration service. Доступен без авторизации.
URL
http://server:8097/
Метод
GET /version
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
{
"ApplicationName": "stn-configuration",
"ApplicationVersion": "1.1.0"
}
29. Получение публичного списка параметров
Метод возвращает ограниченный список параметров, доступный без авторизации. Используется только фронтендом для внутреннего отображения.
URL
http://server:8097/
Метод
GET /parameters/front
Параметры
| Имя | Тип | Описание |
|---|---|---|
| section | string | Раздел администирования, наименование связано с наименованием сервиса |
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
{
"id": "6cdb9d95-ef53-4488-a458-4093df68eb24",
"key": "ARCHIVE_CONSTRUCTOR_CONNECTION_STRING",
"value": "********",
"value_type": "string",
"section_index": 0,
"section": "Архив",
"type": [
{
"id": "4fb4094f-0c65-4211-97cd-10a984949d97",
"value": "stn-archive"
}
],
"description": "Параметры запуска контейнера архива",
"last_updated": "2025-08-19T10:21:39.033693Z"
}
30. Получение списка параметров конфигурации
Данный метод возвращает список всех доступных параметров. Используется всеми сервисами Системы.
URL
http://server:8097/
Метод
GET /parameters
Параметры
| Имя | Тип | Описание |
|---|---|---|
| section | string | Раздел администирования, наименование связано с наименованием сервиса |
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
{
"id": "0197e24d-e5e7-7f5e-b7aa-c462683422d2",
"key": "SEM_ANALYSIS_PERCENTAGE_WORD_CONTAINS",
"value": "10",
"value_type": "uint (>0 <100)",
"section_index": 15,
"section": "Семантический анализ",
"type": [],
"description": "Процент слов которые должны совпасть из запроса и выдачи, чтобы считать выдачу валидной",
"last_updated": "2025-07-07T00:34:05.41548Z"
},
{
"id": "01970d99-6c83-77d6-8e6f-09c6c8b0d63c",
"key": "ASSISTANT_MODEL_API_TIMEOUT",
"value": "101",
"value_type": "uint (>0)",
"section_index": 100,
"section": "Генеративные ответы",
"type": [
{
"id": "8ef1540b-08c6-4ad1-8531-3d6806112b3b",
"value": "stn-assistant"
}
],
"description": "Таймаут запроса от сервиса генеративных ответов к LLM",
"last_updated": "2025-05-26T17:17:28.067355Z"
}
...
31. Получение публичного списка параметров
Метод возвращает ограниченный список параметров, доступный без авторизации. Используется только фронтендом для внутреннего отображения.
URL
http://server:8097/
Метод
GET /parameters/public
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
{
"id": "2610e347-9fb7-486d-beae-6be83d9d1662",
"key": "PERMISSION_SEARCH",
"value": "true",
"value_type": "boolean",
"section_index": 2,
"section": "АРМ",
"type": [
{
"id": "e18b18be-1d65-4fe2-b40a-2329905bbcef",
"value": "stn-frontend"
}
],
"description": "Доступ к подсистеме поиска",
"last_updated": "2025-04-07T06:00:20.087813Z"
},
{
"id": "cf53f8e1-a480-4321-9684-661c32eff521",
"key": "PERMISSION_GENERATION",
"value": "true",
"value_type": "boolean",
"section_index": 3,
"section": "АРМ",
"type": [
{
"id": "e18b18be-1d65-4fe2-b40a-2329905bbcef",
"value": "stn-frontend"
}
],
"description": "Доступ к подсистеме генеративных ответов",
"last_updated": "2025-04-07T06:00:20.087813Z"
}
...
32. Редактирование списка параметров
Метод позволяет редактировать несколько параметров сервиса конфигурирования.
URL
http://server:8097/
Метод
PUT /parameters
Параметры
Параметры запроса отсутствуют.
Тело запроса
[
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"key": "string",
"value": "string",
"value_type": "string",
"section_index": 100,
"section": "string",
"type": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"value": "string"
}
],
"description": "string",
"last_updated": "2025-10-09T12:45:19.038Z"
}
]
П р и м е ч а н и я
- id — уникальный идентификатор параметра (UUID).
- key — системное имя параметра.
- value — сохранённое значение параметра после редактирования.
- value_type — тип значения (
string,uint,boolи т. п.), определяет формат данных вvalue. - section_index — числовой индекс раздела, используется для упорядочивания параметров.
- section — наименование раздела (например, «Семантический анализ», «Генеративные ответы»).
- type — список связанных значений:
- id — идентификатор связанного объекта;
- value — текстовое значение (наименование сервиса).
- description — текстовое описание назначения параметра.
- last_updated — дата и время последнего изменения параметра (формат ISO 8601).
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
"result": "Ok"
33. Редактирование отдельного параметра
Метод позволяет редактировать параметр сервиса конфигурирования.
URL
http://server:8097/
Метод
PUT /parameter
Параметры
Параметры запроса отсутствуют.
Тело запроса
{
"id": "ae9248c0-f896-4a90-a8c8-327f2f6290d7",
"key": "REL_TYPE_SERVICE_TIMEOUT",
"value": "101",
"value_type": "uint",
"section_index": 5,
"section": "Проксибек",
"type": [
{
"id": "9622364c-178e-4cb5-91b2-7cb45364c5c8",
"value": "stn-proxyback"
}
],
"description": "Таймаут сервиса определения типа связи",
"last_updated": "2025-04-07T06:00:20.087813Z"
}
П р и м е ч а н и я
- id — уникальный идентификатор параметра (UUID).
- key — системное имя параметра.
- value — сохранённое значение параметра после редактирования.
- value_type — тип значения (
string,uint,boolи т. п.), определяет формат данных вvalue. - section_index — числовой индекс раздела, используется для упорядочивания параметров.
- section — наименование раздела (например, «Семантический анализ», «Генеративные ответы»).
- type — список связанных значений:
- id — идентификатор связанного объекта;
- value — текстовое значение (наименование сервиса).
- description — текстовое описание назначения параметра.
- last_updated — дата и время последнего изменения параметра (формат ISO 8601).
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
"result": "Ok"
34. Вернуть значение конкретного параметра
Метод позволяет вернуть значение для конкретного параметра
URL
http://server:8097/
Метод
PUT /parameter/id
Параметры
| Имя | Тип | Описание |
|---|---|---|
| id | string | уникальный идентификатор параметра (UUID) |
Тело запроса
{
"id": "ae9248c0-f896-4a90-a8c8-327f2f6290d7",
"key": "REL_TYPE_SERVICE_TIMEOUT",
"value": "101",
"value_type": "uint",
"section_index": 5,
"section": "Проксибек",
"type": [
{
"id": "9622364c-178e-4cb5-91b2-7cb45364c5c8",
"value": "stn-proxyback"
}
],
"description": "Таймаут сервиса определения типа связи",
"last_updated": "2025-04-07T06:00:20.087813Z"
}
П р и м е ч а н и я
- id — уникальный идентификатор параметра (UUID).
- key — системное имя параметра.
- value — сохранённое значение параметра после редактирования.
- value_type — тип значения (
string,uint,boolи т. п.), определяет формат данных вvalue. - section_index — числовой индекс раздела, используется для упорядочивания параметров.
- section — наименование раздела (например, «Семантический анализ», «Генеративные ответы»).
- type — список связанных значений:
- id — идентификатор связанного объекта;
- value — текстовое значение (наименование сервиса).
- description — текстовое описание назначения параметра.
- last_updated — дата и время последнего изменения параметра (формат ISO 8601).
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
"result": "Ok"
35. Получение списка тивов сервисов
Метод возвращает список всех доступных типов приложений (сервисов), которые могут использовать параметры.
URL
http://server:8097/
Метод
GET /types
Параметры
Параметры запроса отсутствуют.
Тело запроса
Тело запроса отсутствует.
Ответы
- Код
- Описание
- Пример
200
Успешный ответ
[
{
"id": "0421a61a-b4e9-4b36-9db5-c3949571d312",
"value": "stn-semanalysis"
},
{
"id": "13387ca8-5f1c-41e7-b177-a1bc97cd86f2",
"value": "stn-rel-type"
},
{
"id": "9622364c-178e-4cb5-91b2-7cb45364c5c8",
"value": "stn-proxyback"
},
...
]