Получить статус запроса

GET /api/v1/bots/{uniqueId}/completion/{completionUniqueId}

Возвращает состояние или результат запроса по его идентификатору. Если бот или запрос не найден, возвращается 404; если нет доступа — 403.

URL

https://app.helpfy.ai/api/v1/bots/{uniqueId}/completion/{completionUniqueId}

Адрес своей установки подставьте вместо https://app.helpfy.ai. Идентификаторы в фигурных скобках замените значениями из ответов API.

Заголовки

Заголовок	Значение
Authorization	Basic <base64(email:api_key)>
Accept	application/json

Подробнее — авторизация API.

Параметры запроса

Параметры пути

Параметр	Тип	Обязательный	Описание
uniqueId	строка	Да	Идентификатор бота.
completionUniqueId	строка	Да	Идентификатор записи.

Пример запроса

curl --request GET 'https://app.helpfy.ai/api/v1/bots/11111111-1111-4111-8111-111111111111/completion/11111111-1111-4111-8111-111111111111' \
  --user 'user@example.com:api_key' \
  --header 'Accept: application/json'

Ответы

HTTP	Описание
200	Успешный ответ
403	Недостаточно прав для просмотра результата запроса.
404	Бот или запись запроса не найдены.

Пример ответа — HTTP 200

Сокращённый пример; показаны клиентские поля. Значения условные.

{
  "status": "SUCCESS",
  "prompt": "Tell me about document of clients rules",
  "unique_id": "8c36e55b-59d6-4241-9ff2-aba6669f8492",
  "created_at": "2025-01-27T09:33:59.012Z",
  "updated_at": "2025-01-27T09:33:59.012Z",
  "tool_calls_count": 2,
  "bot": {
    "unique_id": "17396bcc-6b29-4b2e-b7fd-63c8eb8b6cc8",
    "name": "Main knowledge bot",
    "primary_language": "ru",
    "first_line_greeting_enabled": true,
    "first_line_greeting_text": "Hello! How can I assist you today?",
    "rag_clarify_enabled": true,
    "scenario_clarify_enabled": false,
    "scenario_clarify_min_confidence": 55,
    "scenario_clarify_margin": 12,
    "allow_public_sources_in_support": true,
    "tools_enabled": false,
    "anonymize_pii": false,
    "max_output_tokens": 1000,
    "created_at": "2024-10-18T14:13:46.180Z",
    "updated_at": "2024-10-18T14:13:46.180Z"
  }
}