Webhooks и AI-отчёты: получение результатов из TrustExam

Веб-хуки

Если в assignment.settings.webhook настроены URL-адреса, TrustExam будет отправлять HTTP-запросы на ваши endpoints при старте и завершении экзамена:

• start_url – вызывается при начале экзамена.

• finish_url – вызывается при завершении экзамена.
  
  

Каждый веб-хук обычно содержит:

• идентификаторы попытки (включая ваш session_data.external_id, если он указан),

• статус и временные метки,

• основную информацию об экзамене,

• дополнительные данные из webhook.post, webhook.query и webhook.headers.
  
  

Используйте веб-хуки, чтобы:

• синхронизировать статусы экзаменов с вашей LMS,

• запускать процессы проверки и оценки,

• уведомлять преподавателей или HR-системы.

Report URL

В ответе backend-API содержится поле:

'''javascript'''

{
  "external_session": { "token": "..." },
  "report_url": "https://app.trustexam.ai/.../report"
}

'''javascript'''

{
  "external_session": { "token": "..." },
  "report_url": "https://app.trustexam.ai/.../report"
}

'''javascript'''

{
  "external_session": { "token": "..." },
  "report_url": "https://app.trustexam.ai/.../report"
}

• report_url – прямая ссылка на отчёт о попытке в интерфейсе TrustExam.

• Её можно использовать в админ-панели или кабинете преподавателя для быстрого доступа к деталям попытки.
  
  

API AI-отчёта по попытке

TrustExam может формировать AI-отчёты по каждой попытке.

GET

https://trust-rating.trustexam.ai/api/v1/actions/reports/ai/ATTEMPT_ID?api_token=API_KEY

https://trust-rating.trustexam.ai/api/v1/actions/reports/ai/ATTEMPT_ID?api_token=API_KEY

https://trust-rating.trustexam.ai/api/v1/actions/reports/ai/ATTEMPT_ID?api_token=API_KEY

Где:

• ATTEMPT_ID – внутренний идентификатор попытки (можно получить из веб-хуков или интерфейса).

• API_KEY – ваш API-ключ для AI-отчётов.
  
  

Ответ содержит структурированную AI-оценку честности экзамена, включая:

• общий риск-скоринг,

• список зафиксированных нарушений,

• таймлайн подозрительных событий,

• рекомендации по ручной проверке.

Используйте этот эндпоинт, если вам нужно:

• автоматизировать принятие решений (например, помечать попытки как «под вопросом»),

• интегрировать риск-оценку в ваши HR- или академические процессы,

• строить собственные дашборды и отчёты.