End points

Intepretación de resultados

Califica las respuestas de la prueba y devuelve la interpretación de los resultados.

Información del recurso

Item Valor
Controlado
Formato de request y response JSON
Autenticación

URL Recurso

POST https://api.psy-tech.net/prueba/interpretacion/slug?config opcionales

Request

{warning} El recurso es controlado y cualquier llamado sin el parámetro auto genera consumo dentro del sistema.

{warning} El sistema no guarda la información de respuestas asociadas al candidato, por lo que no se podrá volver a solicitar un informe previamente generado, sin tener que volver a mandar la información y generar consumo.

Parámetro Descripción Valor Opcional
slug Identificador de la prueba a mostrar slug

Configuraciones opcionales

Parámetro Descripción Tipo Data Default
interpretar Devuelve los textos cualitativos de interpretación de los resultados. Boolean true
informe Devuelve un informe pre renderizado en HTML Boolean false
solo_informe Devuelve solo el informe en HTML. Requiere informe=true Boolean false
auto Para desarrollo, simula las respuestas de un candidato. No genera consumo en el sistema Boolean false

Body

Parámetro Descripción Tipo Data Opcional
candidato Nombre del candidato. String
tiempo Duración de la aplicación de la prueba. Integer
respuestas Respuestas dadas por el candidato. Object
respuestas.grupo_# Número de grupo de respuesta. El número de grupos enviado debe coincidir con el número de grupos de la prueba. Las respuestas deben tener el formato
{# pregunta : valor respuesta}

Ej:
"respuestas":{grupo_1:{1:2,2:4}, grupo_2:{1:1,2:3}}		 Object
solicitado Permite identificar quien o que realizó la solicitud al sistema. Este campo es libre para que el cliente pueda controlar los consumos. String

Respuesta

Parámetro Descripción Tipo data
id Identificador de la interpretación de la prueba. String
candidato Nombre del candidato. String
puntaje Objeto que contiene los puntajes cuantitativos de los resultados. Object
puntaje.nombre Nombre del factor. String
puntaje.valor Puntaje númerico del resultado. Integer
puntaje.contenido Colección que contiene los puntajes cuantitativos cuando existen subfactores. Pueden haber subfatores dentro del subfactor, siempre identificado como "contenido" Collection
puntaje.contenido.nombre Nombre del subfactor. String
puntaje.contenido.valor Puntaje númerico del subfactor. Integer
interpretacion Objeto que contiene los textos de la interpretación cualitativa. Object
interpretacion.nombre Nombre del factor interpretado Object
interpretacion.valor Interpretación del factor. Los saltos de linea están dados por \n String
interpretacion.contenido Colección con interpretación cuando existen subfactores. Pueden haber subfatores dentro del subfactor, siempre identificado como "contenido" Collection
interpretacion.contenido.nombre Nombre del subfactor String
interpretacion.contenido.valor Interpretación del subfactor. Los saltos de linea están dados por \n String
informe Nombre del factor String

Ejemplo

URL

https://api.psy-tech.net/prueba/interpretacion/ancla_carrera

https://api.psy-tech.net/prueba/interpretacion/ancla_carrera?interpretar=false&informe=true

REQUEST

Headers

{
    "Content-type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer sxAv7tCCM7gaMy3WROOw76gSM25ws43mXsXldNdX..."
}

Body

{
    "candidato":"Sistema",
    "tiempo":30,
    "respuestas": 
    {
        "grupo_1": {"1": 3, "2": 4, "3": 2, "4": 4, "5": 2, "6": 2}
    },
    "solicitado": "Test"

}

RESPONSE

OK (200)

{
    "id": null,
    "candidato": "Generado Por Sistema",
    "tiempo": 5,
    "puntaje": [
        {
            "nombre": "Percentil",
            "valor": 35
        }
    ],
    "interpretacion": [
        {
            "nombre": "Interpretación",
            "valor": "El método y orden contempla la capacidad de determinar eficazmente las metas y prioridades de su tarea\/área\/proyecto estipulando la acción, los plazos y los recursos requeridos. Incluye la instrumentación de mecanismos de seguimiento y verificación de la información. Generado Por Sistema formula objetivos racionales para los planes determinados, calculando los tiempos y programa las actividades, definiendo prioridades. Le gusta establecer fechas de seguimiento, teniendo en cuenta los plazos finales. Utiliza los recursos disponibles con eficiencia y suele verificar el progreso de las tareas o asignaciones a medida que se producen los avances"
        }
    ]
}

ERROR (404)

{
  "error": "Prueba no encontrada",
  "error_description": "La prueba asd no se encontró en el sistema",
  "hint": "Verifique el slug",
  "message": "La prueba asd no se encontró en el sistema"
}

ERROR (422)

{
  "error": "Errores al interpretar",
  "error_description": [
    "Falta respuesta número 41 de grupo 1",
    "Falta respuesta número 42 de grupo 1"
  ],
  "hint": "Revise la estructura de los datos",
  "message": "Han sucedido errores al realizar la interpretación"
}

ERROR (402)

{
  "error": "Sin pruebas",
  "error_description": "No le quedan pruebas en el paquete adquirido",
  "hint": "Compre un paquete adicional de pruebas",
  "message": "No le quedan pruebas en el paquete adquirido"
}