======Access to flooding data ======

===== Who is this guide for =====

  * The Dublinked team

===== What this guide teaches =====

  * How flooding data can be accessed 
  * How flooding data is protected

===== Things to know beforehand =====

[[https://data.smartdublin.ie|Dublinked]] is the portal that hosts the flooding datasets and associated resources (csv files, links to API, etc).
There is one [[https://data.smartdublin.ie/dataset/flooding-disclaimer| public dataset]] as an entry point for the flooding project where users can find information about the project and how to access it.
There are 5 flooding datasets
  * [[https://data.smartdublin.ie/dataset/dcc-river-level-data|DCC River Level]]
  * [[https://data.smartdublin.ie/dataset/dcc-weather-data|DCC Weather]]
  * [[https://data.smartdublin.ie/dataset/dcc-rainfall-data|DCC Rainfall]]
  * [[https://data.smartdublin.ie/dataset/flooding-data-pervasive-nation|PN Rainfall]]
  * [[https://data.smartdublin.ie/dataset/river-level-data-dunraven|Dunraven River Level]]
The datasets are private and only [[https://data.smartdublin.ie|Dublinked]] registered users - who belong to the flooding org - can access them.

====API====
The [[https://flooding.staging.derilinx.com/api/v1/resources/ui/#|API]] is an alternative way to access flooding data, designed mainly for developers or 'huge data consumers'.
The [[https://flooding.staging.derilinx.com/api/v1/resources/ui/#|API]] is protected by an API key, this means that anybody can access the main [[https://flooding.staging.derilinx.com/api/v1/resources/ui/#)|API web page]], but without the API key all queries will result in an 'unauthorized' error.
To use the API key click in 'Authorize' button in the [[https://flooding.staging.derilinx.com/api/v1/resources/ui/#)|API]] header.

====To sum up====
[[https://data.smartdublin.ie|Dublinked]] credentials are used to access the datasets in [[https://data.smartdublin.ie|Dublinked]].
The [[https://flooding.staging.derilinx.com/api/v1/resources/ui/#|API]] works only if the API key is used in the query, else resulting in unauthorized access.