Glosario de términos
Términos | Significado |
---|---|
NUSS | Número de seguridad social |
Identificador | Es el identificador de AFILIACIONES. |
Definiciones en el esquema que contiene la lógica de los servicios
...
Plantilla | Manejador | Parámetro | Body | Tipo autenticación | Comentario |
---|---|---|---|---|---|
rest/v1.0/private/ce/nuss/consulta/ | GET | Identificador | Bearer token | Consulta del NUSS asociado a un identificador de afiliaciones. Requiere autenticación por token previo. Para la obtención del token se requiere realizar la petición a la url https://daas<ENTORNO>.um.es/ords/zeus/rrhh/open-api-catalog/ss/ pasando un cliente y una contraseña previamente consensuada con el grupo de RRHH. La petición requiere el parámetro identificador de AFILIACIONES. El mensaje de respuesta será un JSON definido de esta forma: { "items": Si encuentra el NUSS asociado al identificador, el objeto items contendrá el elemento nuss con el valor que corresponda. El elemento count valdrá 1. Si no encuentra el NUSS, el objeto items aparecerá vacío y el elemento count aparecerá con valor 0. | |
rest/v1.0/private/ce/nuss/gestion/ | GET | Identificador | Bearer token | Consulta del NUSS asociado a un identificador de afiliaciones. Requiere autenticación por token previo. Para la obtención del token se requiere realizar la petición a la url https://daas<ENTORNO>.um.es/ords/zeus/rrhh/open-api-catalog/ss/ pasando un cliente y una contraseña previamente consensuada con el grupo de RRHH. La petición requiere el parámetro identificador de AFILIACIONES. El mensaje de respuesta será un JSON definido de esta forma: { "items": Si encuentra el NUSS asociado al identificador, el objeto items contendrá el elemento nuss con el valor que corresponda. El elemento count valdrá 1. Si no encuentra el NUSS, el objeto items aparecerá vacío y el elemento count aparecerá con valor 0. | |
rest/v1.0/private/ce/nuss/gestion/ | POST | Un JSON: { | Bearer token | Crea un registro en SSOCIAL.CE_DATOS_PERSONALES. La petición intenta una inserción de un registro nuevo con los valores pasados (identificador y NUSS). Requiere autenticación. Url para obtención de token: https://daas<ENTORNO>.um.es/ords/zeus/rrhh/oauth/token?grant_type=client_credentials, donde ENTORNO puede ser: desa, test o nada (para producción). Para la obtención del token se requiere un secreto que debe consensuarse con el grupo de RRHH, responsable del servicio. La petición manda en el cuerpo un JSON con el siguiente formato:
Si la petición es correcta, devolverá lo siguiente:
Si no es correcta, el campo result de la respuesta devolverá "Error", con una descripción en el campo msg | |
rest/v1.0/private/ce/nuss/gestion/ | PUT | Un JSON: { | Bearer token | Modificar un registro en SSOCIAL.CE_DATOS_PERSONALES. Dado un identificador y un NUSS, actualiza el valor del NUSS para ese identificador. Requiere autenticación. Url para obtención de token: https://daas<ENTORNO>.um.es/ords/zeus/rrhh/oauth/token?grant_type=client_credentials, donde ENTORNO puede ser: desa, test o nada (para producción). Para la obtención del token se requiere un secreto que debe consensuarse con el grupo de RRHH, responsable del servicio. La petición manda en el cuerpo un JSON con el siguiente formato:
Si la petición es correcta, devolverá lo siguiente:
Si no es correcta, el campo result de la respuesta devolverá "Error", con una descripción en el campo msg | |
rest/v1.0/private/ce/nuss/gestion/ | DELETE | Un JSON: { | Bearer token | Elimina un registro en SSOCIAL.CE_DATOS_PERSONALES. Es necesario indicar el identificador y el NUSS del registro a eliminar. Requiere autenticación. Url para obtención de token: https://daas<ENTORNO>.um.es/ords/zeus/rrhh/oauth/token?grant_type=client_credentials, donde ENTORNO puede ser: desa, test o nada (para producción). Para la obtención del token se requiere un secreto que debe consensuarse con el grupo de RRHH, responsable del servicio. La petición manda en el cuerpo un JSON con el siguiente formato:
Si la petición es correcta, devolverá lo siguiente:
Si no es correcta, el campo result de la respuesta devolverá "Error", con una descripción en el campo msg |
Autenticación de los clientes que hacen peticiones a los servicios
Cada cliente que requiera utilizar alguno de estos servicios deberá solicitarlo al grupo de RRHH poniendo un Jira a DJ-AT-RRHH, tal como este:
Alta tarea JIRA | |||
---|---|---|---|
Tipo de tarea: | "Petición de Servicio" | Aplicación: | DJ-AT-RRHH |
Resumen: | Solicitud acceso y credenciales a servicios web ORDS. Esquema: RS_RRH, Módulo: SS (ce/nuss) | ||
Mensaje: | En el texto de la petición deberá justificar la necesidad del acceso y se especificará a qué plantilla se desea el acceso:
|
Una vez se resuelva el Jira y se autorice el acceso, el grupo de RRHH le facilitará un secreto (client_id y secret_id) que usted necesita conservar y que utilizará para poder obtener un token previo a cada petición que realice a los servicios. El token puede obtenerlo a través de estas urls. La duración del token será de una hora y deberá utilizarlo en cada una de las peticiones que realice pasándolo como tipo de autenticación Bearer token.
Acceso a la definición de la API con herramienta swagger
...
Puede utilizar cualquier herramienta, como Postman o Insomnio para probar las peticiones a los servicios. El siguiente archivo json contiene la definición de las peticiones para Insomnio.
View file