API Plataforma de Olores Salimax

Esta API entrega datos historicos y reportes de la plataforma de monitoreo de olores. Los endpoints de datos requieren autenticacion.

Autenticacion

POST /api/token/: emite tokens JWT access y refresh usando username y password.
POST /api/token/refresh/: renueva el token access usando un token refresh vigente.
GET /api/users/me/: retorna los datos basicos del usuario autenticado.
GET /api-auth/login/: inicio de sesion web de Django REST Framework.
GET /api-auth/logout/: cierre de sesion web.

Narices electronicas

Datos por hora

GET /noses/<nose>/<year>/<month>/<day>/<hour>

Retorna las mediciones disponibles para una nariz electronica durante una hora especifica.

Parametros:

nose: identificador operacional, por ejemplo PES_4, TK31, MOLI, PAR.
year: ano con cuatro digitos.
month: mes numerico.
day: dia numerico.
hour: hora en formato 24 horas.

Ejemplo:

/noses/PES_4/2026/4/10/13

Respuesta: JSON con datetime, ou, nh3, h2s y voc.

Datos por dia

GET /noses/<nose>/<year>/<month>/<day>

Retorna las mediciones disponibles para una nariz electronica durante el dia UTC especificado, usando la misma estructura de respuesta del endpoint por hora.

Ejemplo:

/noses/PES_4/2026/4/10

Promedios mensuales

GET /mean/noses/<year>/<month>

Descarga un CSV con promedios horarios mensuales para las narices electronicas.

Parametros opcionales:

?stats: descarga estadisticas mensuales.
?plot: retorna un grafico PNG.
?plot&oid=<oid>: retorna el grafico PNG de un OID especifico.

Ejemplos:

/mean/noses/2026/4
/mean/noses/2026/4?stats
/mean/noses/2026/4?plot&oid=66

Percentiles mensuales

GET /percentiles/noses/<chemical>/<year>/<month>

Descarga un CSV con maximo, promedio y percentiles mensuales por punto de monitoreo.

Parametros:

chemical: una de las columnas disponibles: ou, nh3, h2s o voc.
year: ano con cuatro digitos.
month: mes numerico.

Ejemplo:

/percentiles/noses/ou/2026/4

Receptores

Datos diarios por receptor

GET /receptors/<id>/<year>/<month>/<day>

Retorna las mediciones disponibles para un receptor durante el dia local de Chile especificado.

Parametros:

id: identificador numerico del receptor en recepteurs.csv.
year: ano con cuatro digitos.
month: mes numerico.
day: dia numerico.

Ejemplo:

/receptors/1/2026/4/10

Respuesta: JSON con datetime, ou e id.

Promedios mensuales de receptores

GET /mean/receptors/<year>/<month>

Descarga un CSV con promedios horarios mensuales para receptores seleccionados.

Ejemplo:

/mean/receptors/2026/4

Plumas

Matrices del dia actual

GET /plumes

Consulta las matrices de pluma almacenadas durante el dia actual, usando la zona horaria de Chile, y retorna una matriz promedio calculada desde la columna matrix_data.

Parametros opcionales:

document=data: retorna los datos en un archivo tar.gz. Es el valor por defecto.
document=png: retorna una imagen PNG limpia de la pluma sobre el mapa, sin barra de escala, etiquetas de ejes, ticks ni grillas rotuladas. Las dos primeras columnas definen la grilla estructurada x e y.
document=pdf: retorna un PDF generado desde la misma imagen de la matriz promedio, sin mostrar los valores 0.

Las imagenes png y pdf usan una ventana geografica fija: longitud -70.20269 a -70.15787 y latitud -20.81370 a -20.72840.

Ejemplos:

/plumes
/plumes?document=png
/plumes?document=pdf

Con document=data, la respuesta es un archivo plumes.tar.gz que contiene plumes.json. El JSON incluye start_datetime, end_datetime, count y matrix. Si no hay datos para el dia actual, count es 0 y matrix es una lista vacia.

Con document=png, la respuesta es un archivo plumes.png. Con document=pdf, la respuesta es un archivo plumes.pdf.

Administracion

GET /admin/: administracion de Django.