Integración de API de Psicometricas.com

El API de Psicométricas está diseña sobre REST, por lo tanto encontrarás que las URL están orientadas a recursos y se usa códigos de respuesta HTTP para indicar los errores en la API. Todas las respuestas de la API están en formato JSON, incluyendo los mensajes de error.

Descargar Manual

API Endpoints

Usa las credenciales que se generaron al momento de tu registro para realizar la integración de tu sistema con Psicométricas. Las siguientes URIs forman la base de los endpoints:
URI Base: https://admin.psicometricas.mx/api/

Autenticación

Para realizar peticiones a la API de Psicométricas es necesario enviar el Token (API Clave) y la contraseña en todas las llamadas a nuestro servidor.

Por razones de seguridad todas las peticiones deben ser vía **HTTPS**.

Pruebas Disponibles

Listado de Pruebas

Pruebas	Nombre
1	Cleaver
2	Kostick
3	IPV
4	LIFO
5	Zavic
7	Terman
9	Ingles
10	16PF
11	Barsit
15	Moss
16	Wonderlic

Agregar una Bateria

Método: POST

URL: https://admin.psicometricas.mx/api/agregaBateria

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Battery	string (requerido, longitud = 200) Nombre(s) de la batería
Tests	string (requerido, longitud = 100) Listado de pruebas separadas por comas (Ejemplo: 1,2,3)

Pruebas	Nombre
1	Cleaver
2	Kostick
3	IPV
4	LIFO
5	Zavic
7	Terman
9	Ingles
10	16PF
11	Barsit
15	Moss
16	Wonderlic

Ejemplo de Petición

https://admin.psicometricas.mx/api/agregaBateria

Parámetros en Post


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Battery -> Nombre de la bateria
  Tests  -> 1, 2, 3

Ejemplo de Respuesta


  {
  "status"  : "200"
  "Clave"  : ""1-EUPQ-0116-1649"
  "msg"  : "Bateria agregada correctamente."
  }

Actualiza una Bateria

Método: PUT

URL: https://admin.psicometricas.mx/api/actualizaBateria

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Battery	string (requerido, longitud = 200) Nombre de la batería, si se deja vacía se mantiene el nombre actual
Tests	string (requerido, longitud = 100) Listado de pruebas separadas por comas (Ejemplo: 1,2,3)

Pruebas	Nombre
1	Cleaver
2	Kostick
3	IPV
4	LIFO
5	Zavic
7	Terman
9	Ingles
10	16PF
11	Barsit
15	Moss
16	Wonderlic

Ejemplo de Petición

https://admin.psicometricas.mx/api/agregaBateria

Parámetros en Post


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Battery -> Nombre de la batería, si se envía como vacío, se
    mantendrá el nombre actual
    
  Tests  -> 1, 2, 3

Ejemplo de Respuesta


  {
  "status"  : "200"
  "msg"  : ""Batería modificada correctamente."
  }

Consultar Listado de Baterias

Método: GET

URL: https://admin.psicometricas.mx/api/consultaBateria

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)

Ejemplo de Petición

https://admin.psicometricas.mx/api/consultaBateria

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña

Ejemplo de Respuesta


  {
  "clave"  : ""1-IFCE-1019-1XXX"",
  "nombre"  : ""Nuevo ingreso"",
  "fecha"  : ""2020-10-19 14:46:12"
  },
  {
    "clave"  : ""1-RRTS-0919-2XXX"",
    "nombre"  : ""Nuevo ingreso"",
    "fecha"  : ""2020-10-19 14:46:12"
    },
    {
      "clave"  : """1-IFCE-1520-3XXX"",
      "nombre"  : ""Nuevo ingreso"",
      "fecha"  : ""2020-10-19 14:46:12"
      }

Consultar Batería

Método: GET

URL: https://admin.psicometricas.mx/api/consultaBateria

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Clave	string (requerido, longitud = 20)

Ejemplo de Petición

https://admin.psicometricas.mx/api/consultaBateria

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Clave  -> Clave de la batería a consultar

Ejemplo de Respuesta


  {
  "num_prueba"  : "2",
  "nombre_prueba"  : "Cleaver",
  "nombre"  : "Nuevo Ingreso",
  "clave"  : "1-IFCE-1019-1XXX",
  "estatus"  : "1"
  },
  {
    "num_prueba"  : "2",
    "nombre_prueba"  : "Kostick",
    "nombre"  : "Nuevo Ingreso",
    "clave"  : "1-IFCE-1019-1XXX",
    "estatus"  : "1"
    }

Agregar un nuevo Candidato

Método: POST

URL: https://admin.psicometricas.mx/api/agregaCandidato

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Candidate	string (requerido, longitud = 200) Nombre(s) del candidato
Email	string (requerido, longitud = 100) Cuenta de correo electrónico del Candidato
Vacancy	string (requerido, longitud = 100) Nombre de la vacante
Tests	string (requerido, longitud = 100) Listado de pruebas separadas por comas (Ejemplo: 1,2,3)
Lang	String (Opcional, Default Mx) Mx – México, Es - España

Pruebas	Nombre
1	Cleaver
2	Kostick
3	IPV
4	LIFO
5	Zavic
7	Terman
9	Ingles
10	16PF
11	Barsit
15	Moss
16	Wonderlic

Ejemplo de Petición

https://admin.psicometricas.mx/api/agregaCandidato.

Parámetros en Post


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Candidate  -> Nombre del candidato
  Email  -> [email protected]
  Vacancy  -> Vacante a la que aplica
  Tests  -> 1, 2, 3
  Lang  -> Mx

Ejemplo de Respuesta


  {
  "status"  : "200",
  "clave"  : "1-EUPQ-0116-164",
  "msg"  : "Candidato agregado correctamente."
  }

Actualizar pruebas en un Candidato

Método: PUT

URL: https://admin.psicometricas.mx/api/actualizaCandidato

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Clave	String (requerido, longitud = 20)Clave de candidato
Tests	String (requerido, longitud = 100) Listado de pruebas separadas por comas (Ejemplo: 1,2,3)
Lang	String (Opcional, Default Mx) Mx – México, Es - España

Ejemplo de Petición

https://admin.psicometricas.mx/api/actualizaCandidato.

Parámetros


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Clave  -> Clave del candidato
  Tests  -> 1, 2, 3
  Lang  -> Mx

Ejemplo de Respuesta


  {
  "status"  : "200",
  "clave"  : "Clave del candidato4",
  "msg"  : "Candidato actualizado correctamente."
  }

Consultar Candidato

Método: GET

URL: https://admin.psicometricas.mx/api/consultaCandidato.

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Clave	string (requerido, longitud = 200) Clave del candidato

Ejemplo de Petición

https://admin.psicometricas.mx/api/consultaCandidato
.

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Clave  -> 1-GABF-0110-2220

Ejemplo de Respuesta


  {
  "clave"  : "1-EUPQ-0116-164"
  "nombre"  : "Nombre del candidato"
  "correo_ele"  : "[email protected]"
  "vacante"  : "Sistemas"
  "fecha"  : "2020-01-10 16:20:15"
  "id_prueba"  : 2
  "nombre_prueba"  : "kostick"
  "estatus"  : 2
  "fecha_fin"  : null
  "status_practica"  : 0

  }

Consultar Listado de Candidatos

Método: GET

URL: https://admin.psicometricas.mx/api/consultaCandidato.

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)

Ejemplo de Petición

https://admin.psicometricas.mx/api/consultaCandidato
.

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña

Ejemplo de Respuesta


  {
  "clave"  : "1-EUPQ-0116-164",
  "nombre"  : "Nombre del candidato",
  "correo_ele"  : "[email protected]",
  "fecha"  : "2020-01-10 16:20:15",
  "vacante"  : "Sistemas",
  "estatus"  : 2
  },
  {
    "clave"  : "1-VCFS-0110-2225",
    "nombre"  : "Nombre del candidato",
    "correo_ele"  : "[email protected]",
    "fecha"  : "2020-01-10 16:20:15",
    "vacante"  : "Test",
    "estatus"  : 2
    }

Consultar Reporte

Método: GET

URL: https://admin.psicometricas.mx/api/consultaResultado

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Clave	string (requerido, longitud = 200) Clave del candidato
Pdf	Boolean(default false; se debe enviar el valor true para PDF)

Ejemplo de Petición

https://admin.psicometricas.mx/api/consultaCandidato
.

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Clave  -> 1-GABF-0110-2220
  Pdf  -> True

Ejemplo de Respuesta

Devuelve el archivo PDF del resultado

Para obtener el resultado en formato JSON el parámetro Pdf debe enviarse como false

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Clave  -> 1-GABF-0110-2220
  Pdf  -> False

Ejemplo de Respuesta

Devuelve el resultado en formato JSON

Consultar Reporte de una Prueba Específico

Método: GET

URL: https://admin.psicometricas.mx/api/consultaResultado

Parámetro	Descripción
Token	string (requerido, longitud = 20)
Password	string (requerido, longitud = 20)
Clave	string (requerido, longitud = 200) Clave del candidato
Prueba	Integer (requerido, longitud = 2) Numero de la prueba a consultar
Pdf	Boolean(default false; se debe enviar el valor true para PDF)

Ejemplo de Petición

https://admin.psicometricas.mx/api/consultaCandidato
.

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Clave  -> 1-GABF-0110-2220
  Prueba  -> 1
  Pdf  -> True

Ejemplo de Respuesta

Devuelve el archivo PDF del resultado

Para obtener el resultado en formato JSON el parámetro Pdf debe enviarse como false

Parámetros en GET


  Token  -> Valor generado en la creación de la cuenta
  Password  -> Contraseña
  Clave  -> 1-GABF-0110-2220
  Prueba  -> 1
  Pdf  -> False

Ejemplo de Respuesta

Devuelve el resultado en formato JSON

Webhook

La configuración de webhooks le permite al servicio API enviar actualizaciones cuando el estado de los candidatos cambia, ya sea que hayan terminado la práctica de una prueba o de responder la prueba.

Configuaración de Webhook

Es necesario ingresar a la cuenta de psicométricas y en la sección de “Registros de API”, en donde se encontrara un botón

Una vez realizada la configuración, cada que un candidato termina de responder una práctica o una prueba.

Notificación Webhook

Respuesta cuando el candidato termina de responder una práctica:


  {
  "clave_bateria"  : "null",
  "clave"  : "1-HOHD-0406-0101",
  "practica"  : "true",
  "prueba"  : "1",
  "nombre_prueba"  : "Cleaver",
  "type"  : "termina_practica",
  "nombre_candidato"  : "Juan Rivera",
  "correo_candidato"  : "[email protected]",
  "profesion_candidato"  : "AUX: DE SISTEMAS",

  }

Respuesta cuando el candidato termina de responder una práctica:


  {
  "clave_bateria"  : "null",
  "clave"  : "1-HOHD-0406-0101",
  "practica"  : "false",
  "prueba"  : "1",
  "nombre_prueba"  : "Cleaver",
  "type"  : "termina_prueba",
  "nombre_candidato"  : "Juan Rivera",
  "correo_candidato"  : "[email protected]",
  "profesion_candidato"  : "AUX: DE SISTEMAS",

  }

Errores

Códigos de Error

Agregar Candidato

Código	Error HTTP	Causa
1001	401 - Accesos incorrectos	El token o la contraseña son incorrectos para el usuario
1002	402 - Actualmente no cuenta con un paquete activo	La cuenta no tiene un paquete activo, se debe realizar una contratación para las peticiones
1003	409 - El paquete activo no es compatible con el API	Se cuenta con un paquete activo, pero para utilizar el API se requiere la activación de un paquete compatible.
1004	422 - Todos los valores son obligatorios	Todos los valores son obligatorios y se debe enviar la información para el alta del candidato.

Consultar Candidato

Código	Error HTTP	Causa
1001	401 - Accesos incorrectos	El token o la contraseña son incorrectos para el usuario
1002	402 - Actualmente no cuenta con un paquete activo	La cuenta no tiene un paquete activo, se debe realizar una contratación para las peticiones
1003	409 - Accesos incorrectos	Se cuenta con un paquete activo, pero para utilizar el API se requiere la activación de un paquete compatible.

Consultar Listado de Candidatos

Código	Error HTTP	Causa
1001	401 - Accesos incorrectos	El token o la contraseña son incorrectos para el usuario
1002	402 - Actualmente no cuenta con un paquete activo	La cuenta no tiene un paquete activo, se debe realizar una contratación para las peticiones
1003	409 - El paquete activo no es compatible con el API	Se cuenta con un paquete activo, pero para utilizar el API se requiere la activación de un paquete compatible.

Consultar Candidato

Código	Error HTTP	Causa
1001	401 - Accesos incorrectos	El token o la contraseña son incorrectos para el usuario
1002	402 - Actualmente no cuenta con un paquete activo	La cuenta no tiene un paquete activo, se debe realizar una contratación para las peticiones
1003	409 - El paquete activo no es compatible con el API	Se cuenta con un paquete activo, pero para utilizar el API se requiere la activación de un paquete compatible.

Psicométricas

Síguenos en

Integración de API de Psicometricas.com

API Endpoints

Autenticación

Pruebas Disponibles

Agregar una Bateria

Actualiza una Bateria

Consultar Listado de Baterias

Consultar Batería

Agregar un nuevo Candidato

Actualizar pruebas en un Candidato

Consultar Candidato

Consultar Listado de Candidatos

Consultar Reporte

Consultar Reporte de una Prueba Específico

Webhook

Configuaración de Webhook

Errores

Códigos de Error

Teléfonos

E-mail

Funciones

Extras

Evaluaciones Disponibles

Integración de API de Psicometricas.com

API Endpoints

Autenticación

Pruebas Disponibles

Agregar una Bateria

Actualiza una Bateria

Consultar Listado de Baterias

Consultar Batería

Agregar un nuevo Candidato

Actualizar pruebas en un Candidato

Consultar Candidato

Consultar Listado de Candidatos

Consultar Reporte

Consultar Reporte de una Prueba Específico

Webhook

Configuaración de Webhook

Errores

Códigos de Error