La API Pólenes provee información sobre la cantidad de granos por m3 de aire presente de árboles, gramíneas y hierbas en la ciudad de Bahía Blanca, Provincia de Buenos Aires, Argentina.
Además de esto, categoriza los resultados en tres niveles: bajo, medio y alto. De esta forma, los resultados son más fácilmente interpretados por el público general.
Para poder leer todas las entradas disponibles en la base de datos, realice la siguiente petición:
GET /v2/polenes/leer/todas| Clave | Tipo | Valor |
|---|---|---|
| error | Boolean |
Propiedad que determina si hubieron errores o no.
Importante: se retornará un estado HTTP 200 tanto en true como en false. Si no se encontraran entradas, se retornará un mensaje con un estado HTTP 404.
|
| datos | JSON Array |
Arreglo de objetos JSON que contiene la información de cada entrada. Los valores identificados por los sufijos _bajo y _medio indican los límites para considerarlos como tal (densidad relativamente baja y media). Cualquier valor mayor al límite medio se considera alto y se extiende hasta MAXINT.
Cada entrada contiene las siguientes propiedades:
|
| mensaje | String | Un mensaje detallando el error encontrado. |
Esta petición producirá una salida parecida a la siguiente:
{
"error": false,
"datos": [
{
"arboles": 48,
"arboles_bajo": 14,
"arboles_medio": 89,
"gramineas": 1,
"gramineas_bajo": 4,
"gramineas_medio": 19,
"hierbas": 5,
"hierbas_bajo": 9,
"hierbas_medio": 49,
"fecha": "2018-08-24"
"observaciones": null
},
{
"arboles": 178,
"arboles_bajo": 14,
"arboles_medio": 89,
"gramineas": 3,
"gramineas_bajo": 4,
"gramineas_medio": 19,
"hierbas": 17,
"hierbas_bajo": 9,
"hierbas_medio": 49,
"fecha": "2018-09-14"
"observaciones": "Se le recomienda a las personas alérgicas a permanecer en sus hogares."
},
{
"arboles": 76,
"arboles_bajo": 14,
"arboles_medio": 89,
"gramineas": 0,
"gramineas_bajo": 4,
"gramineas_medio": 19,
"hierbas": 3,
"hierbas_bajo": 9,
"hierbas_medio": 49,
"fecha": "2018-09-17"
"observaciones": null
}
]
}
Un ejemplo de error producirá una salida parecida a la siguiente:
{
"error": true,
"mensaje": "No se pudieron leer todas las entradas."
}
Para poder leer la entrada más reciente de la base de datos, realice la siguiente petición:
GET /v2/polenes/leer/ultima| Clave | Tipo | Valor |
|---|---|---|
| error | Boolean |
Propiedad que determina si hubieron errores o no.
Importante: se retornará un estado HTTP 200 tanto en true como en false. Si no se encontraran entradas, se retornará un mensaje con un estado HTTP 404.
|
| datos | JSON Object |
Objeto JSON que contiene la información de la entrada. Los valores identificados por los sufijos _bajo y _medio indican los límites para considerarlos como tal (densidad relativamente baja y media). Cualquier valor mayor al límite medio se considera alto y se extiende hasta MAXINT.
La entrada contiene las siguientes propiedades:
|
| mensaje | String | Un mensaje detallando el error encontrado. |
Esta petición producirá una salida parecida a la siguiente:
{
"error": false,
"datos": {
"arboles": 76,
"arboles_bajo": 14,
"arboles_medio": 89,
"gramineas": 0,
"gramineas_bajo": 4,
"gramineas_medio": 19,
"hierbas": 3,
"hierbas_bajo": 9,
"hierbas_medio": 49,
"fecha": "2018-09-17"
"observaciones": null
}
}
Un ejemplo de error producirá una salida parecida a la siguiente:
{
"error": true,
"mensaje": "No se pudo leer la última entrada."
}
Para poder buscar una entrada específica en la base de datos, realice la siguiente petición:
POST /v2/polenes/buscar| Clave | Tipo | Valor |
|---|---|---|
| fecha | String | La fecha correspondiente a la entrada en formato Y-m-d. Ver documentación en PHP.net. |
| Clave | Tipo | Valor |
|---|---|---|
| error | Boolean |
Propiedad que determina si hubieron errores o no.
Importante: se retornará un estado HTTP 200 tanto en true como en false. Si no se encontraran entradas, se retornará un mensaje con un estado HTTP 404.
|
| datos | JSON Object |
Objeto JSON que contiene la información de la entrada. Los valores identificados por los sufijos _bajo y _medio indican los límites para considerarlos como tal (densidad relativamente baja y media). Cualquier valor mayor al límite medio se considera alto y se extiende hasta MAXINT.
La entrada contiene las siguientes propiedades:
|
| mensaje | String | Un mensaje detallando el error encontrado. |
Esta petición, con "fecha": "2018-09-17", producirá una salida parecida a la siguiente:
{
"error": false,
"datos": {
"arboles": 76,
"arboles_bajo": 14,
"arboles_medio": 89,
"gramineas": 0,
"gramineas_bajo": 4,
"gramineas_medio": 19,
"hierbas": 3,
"hierbas_bajo": 9,
"hierbas_medio": 49,
"fecha": "2018-09-17"
"observaciones": null
}
}
Un ejemplo de error producirá una salida parecida a la siguiente:
{
"error": true,
"mensaje": "No se pudo leer la entrada buscada."
}
+54 291 455-4547 / 452-2696