Внешний сервис отправляет данные консультации одним POST-запросом — PsyAI обрабатывает их и возвращает этап раскрытия, комментарий и принятое решение.
Поля передаются массивом input_fields — новые столбцы добавляются без изменения API.
Данные консультации анализируются на стороне PsyAI и возвращаются тремя полями: этап раскрытия, комментарий и принятое решение.
Каждый запрос с API-ключом через Authorization: Bearer или X-API-Key.
Результат возвращается в том же ответе. Без базы данных — stateless-сервис.
Полный контракт интеграции для внешних разработчиков.
Content-Type: application/json; charset=utf-8 Authorization: Bearer <API_KEY> # или альтернативно: X-API-Key: <API_KEY>
{
"request_id": "req_2026_05_20_001",
"source": "partner_service_name",
"schema_version": "1.0",
"consultation_id": "consultation_123",
"input_fields": [
{ "key": "date", "label": "Дата", "value": "2026-02-27" },
{ "key": "child", "label": "Ребёнок", "value": "Анастасия, 12 лет" },
{ "key": "reason_for_request", "label": "Причина обращения",
"value": "помощь в раскрытии диагноза" }
]
}
{
"request_id": "req_2026_05_20_001",
"consultation_id": "consultation_123",
"consultation_text": "Дата: 2026-02-27. Ребёнок: Анастасия, 12 лет. Причина обращения: помощь в раскрытии диагноза."
}
{
"status": "success",
"request_id": "req_2026_05_20_001",
"consultation_id": "consultation_123",
"result": {
"disclosure_stage": "Этап 3.1: Встреча 1, Глава 1",
"ai_comment": "Проведена первичная консультация…",
"ai_decision": "Рекомендуется продолжить работу по протоколу…"
}
}
{
"status": "error",
"request_id": "req_2026_05_20_001",
"consultation_id": "consultation_123",
"error": { "code": "missing_required_field", "message": "Missing input_fields or consultation_text" }
}
| Код ошибки | HTTP | Когда |
|---|---|---|
unauthorized | 401 | Отсутствует или неверный API-ключ |
invalid_request | 400 | Некорректный формат запроса |
missing_required_field | 400 | Нет input_fields и consultation_text |
processing_error | 502 | Ошибка обработки на стороне PsyAI |
rate_limit_exceeded | 429 | Превышен лимит запросов |
Поля disclosure_stage, ai_comment, ai_decision генерирует ИИ — их не нужно передавать на вход; если они придут, сервер их проигнорирует.
Заполните ключ и данные консультации — запрос уйдёт на этот же сервер.
Ключ хранится только в этой вкладке браузера и нигде не сохраняется.
Результат появится здесь.
—