Update api-specification.md

api-specification.md

@@ -11,7 +11,7 @@ We would like for all ACTRIS DC units to provide their statistics through an API
 * Monthly unique IPs
 * Download by country
 
-**Filter by: Site, country , product type, download date**
+**Filter by: Facility, country , productType, download date**
 
 Results:
 
@@ -43,15 +43,25 @@ downloadDateTo (optional) Include downloads on or before this date. Expects date
 
 # ACTRIS Data provision
 
-The aim is to answer to the questions: What are the data provided by ACTRIS the previous years. How many sites are contributing aiming for continues long-term measurement? How is this developing over time? How many sites and datasets are included in the NRT data provision?
+The aim is to provide information on the data provided to ACTRIS in the previous years. How many sites are contributing aiming for continues long-term measurement? How is this developing over time? How many sites and datasets are included in the NRT data provision?
 
-Complete the file “ACTRIS_variables_data_provison.xlsx”. To be included there: For each variable in the Data Management Plan, give the number of sites with annual final QA data sets1 separated for the period
+For each variable in the Data Management Plan, give the number of sites with annual final QA data sets1 separated for the period
 
 If relevant; For each period, include campaign data if there are measurements for more than 1 Month. 
 
 ## Metrics
-* Number of sites with QA annual data sets 
-* Number of sites with QA campaign data sets
-* Number of sites with NRT data sets
+* Number of facilities with QA annual data sets 
+* Number of facilities with QA campaign data sets
+* Number of facilities with NRT data sets
 	
-**Filter by: Variables**
+**Filter by: Variable, facility, instrument, country, productType, dateFrom, dateTo**
+
+### GET /api/download/stats
+*Return download statistics based on the following query parameters:*
+
+dimensions: Comma-separated list of dimensions. Supported combinations are yearMonth variable, yearMonth facility and yearMonth instrument, yearMonth country
+sitfacilitye: (optional) Filter downloads based on measurement facility. See https://head-office/api/facility for available facilities.
+country: (optional) Filter downloads based on the country of measurement facilities. The country is specified using ISO 3166-1 alpha-2 code.
+productTypes (optional) Comma-separated list of product types. Supported values are observation, model and fundamentalParameter.
+downloadDateFrom (optional) Include downloads on or after this date. Expects date in YYYY-MM-DD format.
+downloadDateTo (optional) Include downloads on or before this date. Expects date in YYYY-MM-DD format.