Бета-тестирование открыто

INHEX BOT API

REST API для интеграции AI-ассистента в ваши продукты. Погода, новости, переводы, заметки, напоминания и умный LLM — через один эндпоинт.

Запросить доступ Документация

Эндпоинты API

Два метода — всё что нужно для интеграции. Авторизация через заголовки.

GET /ask

Отправить сообщение боту. Бот автоматически выбирает нужный инструмент — погода, новости, перевод и т.д. — или отвечает как LLM-ассистент. Поддерживает синхронный режим и потоковую передачу через Server-Sent Events.

message query, обязательно
Текст запроса пользователя на любом языке.
stream query, опционально
0 (по умолчанию) — синхронный ответ {"answer": "..."}.
1 — SSE-поток: чанки {"delta": "..."}, завершение {"done": true}.
Запрос
GET https://api.inhex.ru/ask?message=Привет
X-Domain-Token: {токен домена}
X-Chat-Token: {токен сессии} # опционально

Синхронный ответ
{ "answer": "Привет! Чем могу помочь?" }

Стриминг (?stream=1)
data: { "delta": "Привет" }
data: { "delta": "! Чем могу" }
data: { "done": true }
PUT /settings

Настроить список доступных сервисов для домена или группы. Передайте массив названий — бот будет использовать только их. Если передан X-Group-Token, настройки применяются к группе и перекрывают настройки домена.

services body, обязательно
JSON-массив названий сервисов. Полный список — в разделе «Сервисы» ниже.
Запрос
PUT https://api.inhex.ru/settings
X-Domain-Token: {токен домена}
X-Group-Token: {токен группы} # опционально
Content-Type: application/json

{ "services": ["weather", "news", "translate"] }

Ответ
{ "ok": true, "services": ["news", "translate", "weather"] }

Заголовки и токены

Авторизация и контекст передаются через HTTP-заголовки. Все токены — 512 символов.

X-Domain-Token ОБЯЗАТЕЛЬНЫЙ
Авторизует организацию. Выдаётся при подключении к API. Без него запрос вернёт 401. Привязывает запросы к настройкам вашего домена.
X-Chat-Token ОПЦИОНАЛЬНЫЙ
Привязывает историю диалога к сессии пользователя. Разные токены — независимые контексты. Генерируете сами: ID пользователя, UUID сессии и т.д.
X-Group-Token ОПЦИОНАЛЬНЫЙ
Привязывает настройки сервисов к группе. Перекрывает настройки домена. Удобно когда разные проекты внутри организации используют разный набор инструментов.

Доступные сервисы

Включите нужные через PUT /settings. По умолчанию все сервисы отключены — работает только LLM-ассистент.

🌤
weather
Текущая погода и прогноз до 16 дней для любого города. Поддерживает конкретную дату: «завтра», «послезавтра», «2026-06-01».
📰
news
Актуальные новости по теме или ключевым словам. Агрегирует из нескольких источников.
🌐
translate
Перевод текста на русский, английский, немецкий, французский и другие языки. Автоопределение источника.
📝
notes
Сохранение, просмотр, поиск и удаление заметок. Привязаны к X-Chat-Token пользователя.
⏰
reminders
Напоминания с доставкой в нужное время. Поддержка повторов: ежедневно, еженедельно, по будням, ежемесячно.
📖
wiki
Поиск и краткие справки из Википедии по любой теме.
💱
currency
Конвертация валют в реальном времени. Курсы ЦБ РФ для рублёвых пар, exchangerate-api для остальных.
🌍
ip_info
Геолокация IP-адреса: страна, город, провайдер, временная зона, координаты.
😄
joke
Случайный анекдот. Для оживления интерфейса или просто настроения.
💡
fact
Случайный интересный факт на русском языке.
💬
quote
Случайная вдохновляющая цитата с автором, переведённая на русский.

Хотите попробовать?

API находится в бета-тестировании. Напишите на почту — расскажите о своём проекте, и мы выдадим токен для доступа. Участие бесплатное.

support@inhex.ru