Testes

A API de Testes permite que você gerencie e acesse testes dentro de sua organização. Você pode recuperar testes existentes, atualizar os testes em suas avaliações e utilizar nossa IA para gerar novos.

Endpoints

Método	Endpoint	Descrição
GET	/tests/organization	Busca todos os testes disponíveis para sua organização.
GET	/tests/assessment/{assessment_id}	Recupera os testes incluídos em uma avaliação específica.
PUT	/tests/assessment/{assessment_id}	Atualiza os testes para uma avaliação específica.
POST	/tests/create/ai	Cria um novo teste usando o gerador de testes com IA.

---

Recuperar Todos os Testes da Organização

Este endpoint recupera uma lista de todos os testes associados à sua organização.

Resposta 200 OK

---

[
  {
    "test_id": "string",
    "name": "string",
    "description": "string",
    "skills": ["string"],
    "language": "string",
    "level": "string",
    "created_date": "datetime",
    "created_by": "string"
  }
]

---

Recuperar Testes de uma Avaliação

Este endpoint retorna os testes que fazem parte de uma avaliação específica, identificada por seu assessment_id.

Parâmetros de Rota

Parâmetro	Tipo	Descrição
assessment_id	string	O identificador exclusivo da avaliação.

Resposta 200 OK

---

[
  {
    "test_id": "string",
    "name": "string",
    "description": "string",
    "num_questions": "integer",
    "skills": ["string"],
    "language": "string",
    "level": "string",
    "relevancy": "string",
    "description_long": "string",
    "time": "integer"
  }
]

---

Atualizar Testes em uma Avaliação

Este endpoint atualiza os testes dentro de uma avaliação específica.

Nota: Esta ação substituirá todos os testes existentes na avaliação pelos fornecidos na solicitação.

Parâmetros de Rota

Parâmetro	Tipo	Descrição
assessment_id	string	O identificador exclusivo da avaliação a ser atualizada.

Corpo da Solicitação

Resposta 200 OK

---

{
  "test_ids": ["string"]
}

---

Criar um Teste com IA

Este endpoint gera um novo teste de múltipla escolha usando IA com base em suas especificações.

Corpo da Solicitação

{
  "prompt": "string",
  "language": "string",
  "extended_thinking": "boolean"
}

---

• prompt: Uma descrição detalhada do teste desejado. Inclua as habilidades a serem avaliadas, o nível de dificuldade e quaisquer outros critérios relevantes.
• language: O idioma para o teste gerado.
• extended_thinking: Defina como true para habilitar um modelo de geração mais avançado para questões de maior qualidade.

Resposta 201 Created

---

{
  "message": "Test created successfully",
  "test": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Sample Test",
    "description": "Short description",
    "num_questions": 10,
    "skills": [
      "skillA",
      "skillB"
    ],
    "language": "English",
    "level": "Intermediate",
    "relevancy": "",
    "description_long": "",
    "time": 15
  },
  "questions": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "question": "Sample question",
      "options": [
        "optionA",
        "optionB",
        "optionC",
        "optionD"
      ],
      "correct_answer": "optionA",
      "created_at": "NOW()",
      "is_question_bank": false,
      "table": "{\"headers\": [\"Header1\", \"Header2\"], \"rows\": [[\"Row1Cell1\", \"Row1Cell2\"], [\"Row2Cell1\", \"Row2Cell2\"]]}"
    }
  ]
}

---

Tratamento de Erros

A API usa códigos de status HTTP padrão para indicar o sucesso ou falha de uma solicitação.

Código de Status	Descrição	Causas Comuns
404 Not Found	O recurso solicitado não pôde ser encontrado.	- assessment_id ou test_id inválido.
422 Unprocessable Entity	A solicitação estava bem formada, mas não pôde ser processada.	- Parâmetros ou formato de solicitação inválidos.
500 Internal Server Error	Ocorreu um erro inesperado no servidor.	- Ocorreu um erro no sistema; por favor, entre em contato com o suporte.