refactor(doc): process parameter `params` as common parameter for all functions

R/doApiQuery.R

@@ -9,7 +9,6 @@
 #'
 #' @param api a [character] name of the API (e.g.: "indicateurs_services", "prelevements"...), see example for available APIs
 #' @param operation a [character] name of the operation, see example for available operations in an API
-#' @param params a [list] the list of parameters of the queries and their values in the format `list(ParamName = "Param value", ...)`, use the function `get_available_params` for a list of the available parameters for a given operation in an API
 #' @template param_get_common
 #'
 #' @return A [list] with the concatenated results returned by the API.

R/get_indicateurs_services_communes.R

@@ -2,7 +2,6 @@
 #'
 #' See the API documentation for available filter parameters: \url{https://hubeau.eaufrance.fr/page/api-indicateurs-services}
 #'
-#' @param params [list] where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters
 #' @template param_get_common
 #'
 #' @return a [tibble::tibble] with one row by commune, by service and by year and the following columns:

R/get_indicateurs_services_indicateurs.R

@@ -2,7 +2,6 @@
 #'
 #' See the API documentation for available filter parameters: \url{https://hubeau.eaufrance.fr/page/api-indicateurs-services}
 #'
-#' @param params [list] where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters
 #' @template param_get_common
 #'
 #' @return a [tibble::tibble] with one row by commune, by service and by year and the following columns:

R/get_prelevements_chroniques.R

@@ -2,7 +2,6 @@
 #'
 #' See the API documentation for available filter parameters: \url{https://hubeau.eaufrance.fr/page/api-prelevements-eau#/prelevements/chronique}
 #'
-#' @param params [list] where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters
 #' @template param_get_common
 #'
 #' @return a [tibble::tibble] with all available parameters in columns and one row by device, year and usage.

R/get_prelevements_points_prelevement.R

@@ -2,7 +2,6 @@
 #'
 #' See the API documentation for available filter parameters: \url{https://hubeau.eaufrance.fr/page/api-prelevements-eau#/prelevements/prelevement}
 #'
-#' @param params [list] where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters
 #' @template param_get_common
 #'
 #' @return a [tibble::tibble] with all available parameters in columns and one row by device.

man-roxygen/param_get_common.R

+#' @param params a [list] the list of parameters of the queries and their values in the format `list(ParamName = "Param value", ...)`, use the function [get_available_params] for a list of the available parameters for a given operation in an API and see the API documentation for the complete list of available filter parameters
 #' @param cfg a [config] object Configuration of the communication. Use by default the internal package
 #'        configuration

man/doApiQuery.Rd

@@ -23,7 +23,7 @@ get_available_params(
 
 \item{operation}{a \link{character} name of the operation, see example for available operations in an API}
 
-\item{params}{a \link{list} the list of parameters of the queries and their values in the format \code{list(ParamName = "Param value", ...)}, use the function \code{get_available_params} for a list of the available parameters for a given operation in an API}
+\item{params}{a \link{list} the list of parameters of the queries and their values in the format \code{list(ParamName = "Param value", ...)}, use the function \link{get_available_params} for a list of the available parameters for a given operation in an API and see the API documentation for the complete list of available filter parameters}
 
 \item{cfg}{a \link{config} object Configuration of the communication. Use by default the internal package
 configuration}

man/get_indicateurs_services_communes.Rd

@@ -10,7 +10,7 @@ get_indicateurs_services_communes(
 )
 }
 \arguments{
-\item{params}{\link{list} where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters}
+\item{params}{a \link{list} the list of parameters of the queries and their values in the format \code{list(ParamName = "Param value", ...)}, use the function \link{get_available_params} for a list of the available parameters for a given operation in an API and see the API documentation for the complete list of available filter parameters}
 
 \item{cfg}{a \link{config} object Configuration of the communication. Use by default the internal package
 configuration}

man/get_indicateurs_services_indicateurs.Rd

@@ -10,7 +10,7 @@ get_indicateurs_services_indicateurs(
 )
 }
 \arguments{
-\item{params}{\link{list} where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters}
+\item{params}{a \link{list} the list of parameters of the queries and their values in the format \code{list(ParamName = "Param value", ...)}, use the function \link{get_available_params} for a list of the available parameters for a given operation in an API and see the API documentation for the complete list of available filter parameters}
 
 \item{cfg}{a \link{config} object Configuration of the communication. Use by default the internal package
 configuration}

man/get_prelevements_chroniques.Rd

@@ -10,7 +10,7 @@ get_prelevements_chroniques(
 )
 }
 \arguments{
-\item{params}{\link{list} where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters}
+\item{params}{a \link{list} the list of parameters of the queries and their values in the format \code{list(ParamName = "Param value", ...)}, use the function \link{get_available_params} for a list of the available parameters for a given operation in an API and see the API documentation for the complete list of available filter parameters}
 
 \item{cfg}{a \link{config} object Configuration of the communication. Use by default the internal package
 configuration}

man/get_prelevements_points_prelevement.Rd

@@ -10,7 +10,7 @@ get_prelevements_points_prelevement(
 )
 }
 \arguments{
-\item{params}{\link{list} where the keys are the names of the filtered parameters and the values are the values of the filters. See the API documentation for the complete list of available filter parameters}
+\item{params}{a \link{list} the list of parameters of the queries and their values in the format \code{list(ParamName = "Param value", ...)}, use the function \link{get_available_params} for a list of the available parameters for a given operation in an API and see the API documentation for the complete list of available filter parameters}
 
 \item{cfg}{a \link{config} object Configuration of the communication. Use by default the internal package
 configuration}