Respuestas
Frecuencia de actualización recomendada: 15 minutos
Con este endpoint se pueden obtener las respuestas de los censos de forma paginada mediante el parámetro batchSize. Es posible filtrar por otros parámetros en simultáneo.
GET
/v1/respuestasParameters
| Parámetro | Tipo | Descripción |
|---|---|---|
| fechaDesde | String | Filtro para obtener las respuestas a partir de una fecha. Formato: "yyyy-MM-dd HH:mm:ss.fff". |
| fechaHasta | String | Filtro para obtener las respuestas hasta una fecha. Mismo formato. |
| batchSize | Int | Cantidad de respuestas a solicitar (máximo 5000). |
| idDesde | Int | Filtro para obtener las respuestas con id igual o mayor al enviado. |
| vendedor | String | Filtro para obtener las respuestas del vendedor enviado. |
| codigoCenso | String | Filtro para obtener las respuestas del código de censo enviado. |
| incluirUrlFoto | Boolean | Filtro para determinar si incluir url con la foto de la respuesta en caso de existir. |
Response body
| Campo | Tipo | Descripción |
|---|---|---|
| id | LongRequired | Código identificador de la respuesta. |
| codigoCenso | String(20)Required | Código identificador del censo asociado a la respuesta. |
| codigoGrupoPreguntas | String(20)Required | Código identificador del grupo de preguntas asociado a la respuesta. |
| codigoPregunta | String(20)Required | Código identificador de la pregunta asociada a la respuesta. |
| codigoCliente | String(20)Required | Código del cliente asociado a la respuesta. |
| codigoVendedor | String(20)Required | Código del vendedor asociado a la respuesta. |
| fecha | DatetimeRequired | Fecha en la que se realizó la respuesta. |
| texto | StringRequired | Texto de la respuesta. |
| urlFoto | String | Url de la foto de la respuesta en caso de que la respuesta sea tipo foto y se mandara en true el filtro "incluirUrlFoto". Es una PreSignedUrl con 15 minutos de expiración. En caso de no existir la foto, devuelve 404 la petición a la url. |
Respuestas
| Código | Significado |
|---|---|
| 200 | Respuestas de censos, paginadas según batchSize. |
| 403 | La API key enviada en X-API-KEY no es válida. |
| 404 | Falta el header X-API-KEY o la URL es incorrecta. |
| 429 | Se superó el límite de 30 requests por minuto. |
| 500 | Error interno del servidor. Reintentar más tarde. |
cURL
curl --location 'https://gateway.axum.com.ar/{tenant}/api/v1/respuestas' \ --header 'X-API-KEY: {tenant-apikey}'
RESPONSE · 200 OK
[
{
"id": 1,
"codigoCenso": "1",
"codigoGrupoPreguntas": "1",
"codigoPregunta": "2",
"codigoCliente": "1000",
"codigovendedor": "02",
"fecha": "2020-01-06 08:04:12",
"texto": "-34.75492999;-58.485121666",
"urlFoto": null
},
{
"id": 3,
"codigoCenso": "1",
"codigoGrupoPreguntas": "1",
"codigoPregunta": "3",
"codigoCliente": "2001",
"codigovendedor": "02",
"fecha": "2020-01-06 09:06:22",
"texto": "foto.jpg",
"urlFoto": "https://url-de-ejemplo.com"
}
]