Influenzanet Send Service

This service allow you to send aggregated data to Influenzanet using CSV files

Data handled

We currently handle datasets for :

How to send data

Before sending data you will need an Authentication key (kind of password), request it by sending a message to the Influenzanet team or on the Influenzanet distribution list

To send data, you need to push data to the server using an HTTP POST request

Several tools can help you to do it

Technical specifications

POST request

Server expects a HTTP POST mulitpart request to the url https://send.influenzanet.info/import/$kind, where $kind is to be replaced by the kind of file to send (e.g. 'incidence' for incidence datasets)

The POST body consists of one field with named file with the content of the file. The provided file name with file must end with '.csv'

Authentication token has to be passed with 'Authentication' Header, as a bearer token, as : "Authentication: Bearer MyVeryRandomKey"

If the URL contains a validate_only parameter with non zero value, only validation of the structure of the file will be done, and the file will not be stored. This can be used to test the file validity before to actually send it.

Response

Server will return status code in range 200-202 if OK and a json body, any other code means there is an error and body contains an error field

if OK, response body contains fields file with created filename (for information), and user with identified user from token

Using cURL

Curl is a little program, widely available to make web request

curl -H "Authentication: Bearer YOURKEY" -F "file=@file.csv" https://send.influenzanet.info/import/incidence

Using R

You can find a A program example on github repository