update api documentation (#971)

server/controllers/staff/get-new-tickets.php

@@ -15,7 +15,8 @@ use Respect\Validation\Validator as DataValidator;
  * @apiPermission staff1
  *
  * @apiParam {Number} page The page number.
- *
+ * @apiParam {Number} departmentId The id of the department searched
+ * 
  * @apiUse NO_PERMISSION
  * @apiUse INVALID_PAGE
  *

server/controllers/staff/get-tickets.php

@@ -15,7 +15,8 @@ use Respect\Validation\Validator as DataValidator;
  *
  * @apiParam {Number} page The page number.
  * @apiParam {bool} closed Include closed tickets in the response.
- *
+ * @apiParam {Number} departmentId The id of the department searched
+ * 
  * @apiUse NO_PERMISSION
  * @apiUse INVALID_PAGE
  *

server/controllers/system/stats.php

@@ -14,7 +14,6 @@ use RedBeanPHP\Facade as RedBean;
  *
  * @apiPermission staff1
  *
- * @apiParam {Number} staffId Id of the current staff.
  * @apiParam {Number[]} tags The ids of the tags for the custom stats.
  * @apiParam {Number[]} dateRange The array with start and end date of the range for the custom stats.
  * @apiParam {Number[]} departments The ids of the departments for the custom stats.

server/controllers/ticket/create.php

@@ -18,6 +18,7 @@ DataValidator::with('CustomValidations', true);
  * @apiParam {String} content Content of the ticket.
  * @apiParam {Number} departmentId The id of the department of the current ticket.
  * @apiParam {String} language The language of the ticket.
+ * @apiParam {String} name The name of author of the ticket.
  * @apiParam {String} email The email of the user who created the ticket.
  * @apiParam {Number} images The number of images in the content.
  * @apiParam {String} apiKey apiKey to create tickets and show ticket-number created.

server/controllers/ticket/search-authors.php

@@ -18,7 +18,8 @@ DataValidator::with('CustomValidations', true);
  * 
  * @apiParam {String} query A string to find into a ticket to make a custom search.
  * @apiParam {Object[]} blackList A array of objects {id, isStaff} with id and boolean to eliminate the authors of the new list.
- *
+ * @apiParam {Boolean} searchUsers A boolean that determinates if the search is for users or not
+ * 
  * @apiUse NO_PERMISSION
  * @apiUse INVALID_QUERY
  *