Descripción general
Los datos recibidos a través de la API se asocian a una estación o dispositivo. Dicho dispositivo viene identificado por un código único.
Para el envío de datos variable valor, se realizará una petición POST con un payload JSON como se especifica más adelante. En el caso de envío de imágenes, se realizará una petición POST en formato "multipart/form-data" como se especifica más adelante.
Todas las peticiones de envío de datos necesitarán proveer un API key en la cabecera HTTP "X-API-Key", que identifica a quién realiza el envío de datos, y deberán estar firmadas mediante HMAC-SHA256 provisto en la cabecera HTTP "X-Signature" como se describe más adelante, utilizando un API secret.
Envío de datos variable-valor
Formato de trama:
{
"HIST": {
"DATA": {
"VAR_1": 0.34,
"VAR_2": "texto"
},
"VERSION": "10.0.0",
"UTC": 1518778157,
"IMEI": "APP-FINCA1-CULTIVO1"
}
}
Las tramas son objetos JSON que representan datos de una estación concreta en una fecha y hora concretas.
...
- Firmar la cadena de texto anterior mediante HMAC-SHA256, utilizando como secreto el API secret provisto por Nazaríes y codificar el resultado en base64
Envío de imágenes
Ejemplo de petición:
curl -i -X POST -H "X-API-Key: api-key" -H "X-Signature: signature" -F "image=@/path/imagen.png" -F "station_code=123456" -F "variable=image" URL
El envío se realizará en formato multipart/form-data, incluyendo los siguientes parámetros: "variable", siempre con valor image; "station_code", contendrá el identificador único de la estación; "image", contendrá
Anchor | ||||
---|---|---|---|---|
|
Cálculo de la firma:
...