Pruebas

La API de Pruebas te permite gestionar y acceder a las pruebas dentro de tu organización. Puedes obtener pruebas existentes, actualizar las pruebas dentro de tus evaluaciones y aprovechar nuestra IA para generar nuevas.

Endpoints

Método	Endpoint	Descripción
GET	/tests/organization	Obtiene todas las pruebas disponibles para tu organización.
GET	/tests/assessment/{assessment_id}	Obtiene las pruebas incluidas en una evaluación específica.
PUT	/tests/assessment/{assessment_id}	Actualiza las pruebas para una evaluación específica.
POST	/tests/create/ai	Crea una nueva prueba usando el generador de pruebas con IA.

---

Obtener Todas las Pruebas de la Organización

Este endpoint obtiene una lista de todas las pruebas asociadas con tu organización.

Respuesta 200 OK

---

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

---

Obtener Pruebas de una Posición

Este endpoint devuelve las pruebas que son parte de una posición específica, identificada por su assessment_id.

Parámetros de Ruta

Parámetro	Tipo	Descripción
assessment_id	string	El identificador único de la posición.

Respuesta 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"
  }
]

---

Actualizar Pruebas en una Posición

Este endpoint actualiza las pruebas dentro de una posición específica.

Nota: Esta acción reemplazará todas las pruebas existentes en la evaluación con las proporcionadas en la solicitud.

Parámetros de Ruta

Parámetro	Tipo	Descripción
assessment_id	string	El identificador único de la posición a actualizar.

Cuerpo de la Solicitud

Respuesta 200 OK

---

{
  "test_ids": ["string"]
}

Response 200 OK

{
  "message": "Assessment tests updated successfully."
}

---

Crear una Prueba con IA

Este endpoint genera una nueva prueba de opción múltiple usando IA según tus especificaciones.

Cuerpo de la Solicitud

---

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

---

• prompt: Una descripción detallada de la prueba deseada. Incluye las habilidades a evaluar, el nivel de dificultad y cualquier otro criterio relevante.
• language: El idioma para la prueba generada.
• extended_thinking: Establécelo en true para habilitar un modelo de generación más avanzado para preguntas de mayor calidad.

Respuesta 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\"]]}"
    }
  ]
}

---

Manejo de Errores

La API utiliza códigos de estado HTTP estándar para indicar el éxito o fracaso de una solicitud.

Código de Estado	Descripción	Causas Comunes
404 Not Found	El recurso solicitado no pudo ser encontrado.	- assessment_id o test_id inválido.
422 Unprocessable Entity	La solicitud estaba bien formada pero no pudo ser procesada.	- Parámetros o formato de solicitud inválidos.
500 Internal Server Error	Ocurrió un error inesperado en el servidor.	- Ha ocurrido un error en el sistema; por favor, contacta a soporte.