Integración de API

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.

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**.

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)

Listado de pruebas disponibles
Pruebas	Nombre
1	Cleaver
2	Kostick
3	IPV
4	LIFO
5	Zavic
7	Terman
9	Ingles
10	16PF
11	Barsit

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 -> candidato_mail@correo.com
Vacancy -> Vacante a la que aplica
Tests -> 1, 2, 3

Ejemplo de respuesta

{ "status" : "200",
"clave" : "1-EUPQ-0116-164",
"msg" : ""Candidato agregado 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 POST

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


Ejemplo de respuesta

{
"clave": "1-GABF-0110-2220",
"nombre": "Nombre del candidato",
"correo_ele": "correo1@correo.com",
"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-GABF-0110-2220",
"nombre": "Nombre del candidato",
"correo_ele": "correo1@correo.com ",
"fecha": "2020-01-10 16:20:15",
"vacante": "sistemas",
"estatus": 1
},
{
"clave": "1-VCFS-0110-2225",
"nombre": "Nombre de candidato",
"correo_ele": "correo2@correo.com",
"fecha": "2020-01-10 16:25:59",
"vacante": "Test",
"estatus": 1
}

Consultar reporte PDF

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)

Ejemplo de petición

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

Parámetros en GET

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


Ejemplo de respuesta

Devuelve el archivo PDF del resultado

Consultar reporte PDF de una prueba en 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)
Prueba	Integer (requerido, longitud = 2) Numero de la prueba a consultar

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-VCFS-0110-2225
Prueba -> 1


Ejemplo de respuesta

Devuelve el archivo PDF del resultado

Errores

PsicometricasMx regresa objetos de JSON en las respuestas del servicio, incluso en caso de errores por lo que cuando exista un error.

Códigos de error