Integración de eventos utilizando la API
Documentación sobre cómo integrar eventos usando la API Ronda senior X.
Prerrequisitos generales
- Estar autenticado en Ronda X senior;
- Pasar el token en el Header.
Consultar eventos descartados
- llame al servicioOBTENER /evento rechazado/búsqueda paginada/todos consultar eventos por período;
- En el postman, los siguientes elementos deben ser pasados en la URL (query) por parámetro: order (1 = creciente, 0 = decreciente), type (0 = acceso, 1 = alarma, 2 = notificación), dataInicio, dataFim, pagina, totalPaginas: https://sam-api.senior.com.br/api/v1/rejectedEvent/pagedsearch/all?order=0&type=0&startDate=2017-03-27T00:00:00-03:00&endDate=2017-03-27T21:55:00-03:00&page=1&pageSize=10
[
{
"datetime": "2017-03-27T18:31:00Z",
"eventType": 0,
"rejectReason": "Credencial no encontrada",
"device":
{
"id": 16,
"name": "Barras",
"deviceType": 1
},
"credential": 0,
"cardNumber": 40001,
"personId": 29,
"biometricManufacturer": 0,
"credentialFormat": "CARD"
}
]
Consultar eventos de acceso y eventos de alarmas
- llame al servicioPOST /monitoreo/acceso/búsqueda de páginas/todos consultar eventos de acceso;
- Los filtros se pueden realizar por fecha de inicio y finalización, tipo de acceso, ubicación física, dispositivos, grupos, personas y roles, según los siguientes tipos:
{
"FechaInicio": "cadena",
"endDate": "cadena",
"tipoAcceso": 0,
"orden": 0,
"página": 0,
"tamaño de página": 0,
"Ubicación física": [0],
"dispositivos": [0],
"grupos": [0],
"personas": [0],
"roles": [0]
}
Informaciones de los servicios
Notas de Implementación
Retornar todos los eventos rechazados
Response Class (Status 200)
Retornar un evento rechazado
{
"datetime": "string",
"eventType": 0,
"rejectReason": "string",
"device":
{
"id": 0,
"name": "string",
"deviceType": 0
},
"credential": 0,
"cardNumber": 0,
"personId": 0,
"biometricManufacturer": 0,
"credentialFormat": "CARD"
}
Parameters
| Parámetros | Descripción | Tipo Parámetro | Tipo Fecha |
|---|---|---|---|
| Afirmación X-JWT | Ficha JWT WSO2 | header | string |
| ID de usuario autenticado X | El ID de usuario que ha iniciado sesión | header | string |
| order | Orden de Filtro (1 para orden ascendiente , 0 para orden descendiente) | query | integer |
| type | Filtro de tipo de evento rechazado (0 = ACCESO, 1 = ALARMA , 2 = NOTIFICACIÓN) | query | string |
| startDate | Start date | query | string |
| endDate | End date | query | string |
| page | Page number | query | integer |
| pageSize | Size of page | query | integer |
Mensajes de Respuesta
| HTTP Código Status | Razón | Modelo de Respuesta |
|---|---|---|
| 401 | Token es inválido o expirado | |
| 500 | Error de Servidor | { "id": "cadena", "código": 0, "mensaje": "cadena" } |
Notas de Implementación
Devuelve una matriz de todos los accesos monitoreados filtrados
Response Class (Status 200)
Devolver una lista de todos los accesos monitoreados
{
"fecha": "cadena",
"credencial": 0,
"persona": {
"identificación": 0,
"nombre": "cadena",
"Documentos obligatorios": [
{
"identificación": 0,
"Tipo de Documento": {
"identificación": 0,
"nombre": "cadena",
"etiqueta": "cadena",
"máscara": "cadena",
"requerido": verdadero,
"documentToREP": verdadero
},
"documento": "cadena"
}
],
"correo electrónico preferencial": {
"identificación": 0,
"preferencial": verdadero,
"dirección de correo electrónico": "cadena"
},
"teléfono preferencial": {
"identificación": 0,
"preferencial": verdadero,
"ddi": 0,
"número de teléfono": "cadena",
"extensionLine": "cadena",
"tipo": "INDEFINIDO"
},
"lastFeedbackPollDate": "cadena",
"useSelfServiceTerminal": verdadero
},
"tipo de acceso": "cadena",
"DestinoUbicaciónfísica": {
"identificación": 0,
"nombre": "cadena"
},
"dispositivo": {
"identificación": 0,
"nombre": "cadena",
"tipo de dispositivo": 0,
"Tecnología lectora": 0
},
"ubicación física del dispositivo": {
"identificación": 0,
"nombre": "cadena"
},
"fabricante biométrico": 0,
"credentialFormat": "TARJETA",
"estado": "FUERA DE CONEXIÓN",
"accessDirection": "ENTRADA"
}
Parameters
| Parámetros | Descripción | Tipo Parámetro | Tipo Fecha |
|---|---|---|---|
| Afirmación X-JWT | Ficha JWT WSO2 | header | string |
| ID de usuario autenticado X | El ID de usuario que ha iniciado sesión | header | string |
| MonitoreoBuscar | MonitoreoBuscar | cuerpo | MonitoreoBuscar { "FechaInicio": "cadena", "endDate": "cadena", "tipoAcceso": 0, "orden": 0, "página": 0, "tamaño de página": 0, "localizacion fisica": [ 0 ], "dispositivos": [ 0 ], "grupos": [ 0 ], "personas": [ 0 ], "roles": [ 0 ] } |
Mensajes de Respuesta
| HTTP Código Status | Razón | Modelo de Respuesta |
|---|---|---|
| 401 | Token es inválido o expirado | |
| 500 | Error de Servidor | { "id": "cadena", "código": 0, "mensaje": "cadena" } |





