quickblox 2.15.1 → 2.15.2

package/src/modules/qbData.js

@@ -13,13 +13,13 @@ function DataProxy(service){
 
 DataProxy.prototype = {
     /**
-     * Create new custom object ({@link https://docsdev.quickblox.com/rest_api/CustomObjects_API.html#Create_object read more})
+     * Create new custom object({@link https://docs.quickblox.com/docs/js-custom-objects#create-records read more}).
      * 
      * @memberof QB.data
      * 
-     * @param {string} className - A class name to which a new object belongs
-     * @param {object} data - Object of parameters (custom fields' names and their values)
-     * @param {createDataCallback} callback - The createDataCallback function
+     * @param {string} className - A class name to which a new object belongs.
+     * @param {object} data - Object of parameters (custom fields' names and their values).
+     * @param {createDataCallback} callback - The createDataCallback function.
      * 
      * @example
      * var data = {
@@ -43,10 +43,10 @@ DataProxy.prototype = {
      */
     create: function(className, data, callback) {
         /**
-         * Callback for QB.data.create(className, data, callback)
+         * Callback for QB.data.create(className, data, callback).
          * @callback createDataCallback
-         * @param {object} error - The error object
-         * @param {object} response - An object
+         * @param {object} error - The error object.
+         * @param {object} response - An object.
          */
         var ajaxParams = {
             'type': 'POST',
@@ -66,16 +66,16 @@ DataProxy.prototype = {
     },
 
     /**
-     * Search for records of particular class ({@link https://docsdev.quickblox.com/rest_api/CustomObjects_API.html#Retrieve_objects read more})
+     * Search for records of particular class({@link https://docs.quickblox.com/docs/js-custom-objects#retrieve-records read more}).
      * 
      * @memberof QB.data
      * 
-     * @param {string} className - A class name to which a new record belongs
-     * @param {(object|string[])} filters - Search records with field which contains exactly specified value or by array of records' ids to retrieve
-     * @param {number} [filters.skip=0] - Skip N records in search results. Useful for pagination. Default (if not specified) - 0
-     * @param {number} [filters.limit=100] - Limit search results to N records. Useful for pagination. Default and max values - 100. If limit is equal to -1 only last record will be returned
-     * @param {string} [filters.*] - {@link https://docsdev.quickblox.com/rest_api/CustomObjects_API.html#Retrieve_objects See more filters' parameters}
-     * @param {listOfDataCallback} callback - The listOfDataCallback function
+     * @param {string} className - A class name to which a new record belongs.
+     * @param {(object|string[])} filters - Search records with field which contains exactly specified value or by array of records' ids to retrieve.
+     * @param {number} [filters.skip=0] - Skip N records in search results. Useful for pagination. Default (if not specified) - 0.
+     * @param {number} [filters.limit=100] - Limit search results to N records. Useful for pagination. Default and max values - 100. If limit is equal to -1 only last record will be returned.
+     * @param {string} [filters.*] - {@link https://docs.quickblox.com/docs/js-custom-objects#search-operators See more filters' parameters}.
+     * @param {listOfDataCallback} callback - The listOfDataCallback function.
      * @example
      * var filter = {
      *     'skip': 0,
@@ -99,10 +99,10 @@ DataProxy.prototype = {
      */
     list: function(className, filters, callback) {
         /**
-         * Callback for QB.data.list(className, filters, callback)
+         * Callback for QB.data.list(className, filters, callback).
          * @callback listOfDataCallback
-         * @param {object} error - The error object
-         * @param {object} response - Object with Array of files
+         * @param {object} error - The error object.
+         * @param {object} response - Object with Array of files.
          */
 
         // make filters an optional parameter
@@ -120,12 +120,12 @@ DataProxy.prototype = {
     },
 
     /**
-     * Update record by ID of particular class. ({@link https://docsdev.quickblox.com/rest_api/CustomObjects_API.html#Retrieve_objects Read more})
+     * Update record by ID of particular class({@link https://docs.quickblox.com/docs/js-custom-objects#update-records Read more}).
      * @memberof QB.data
-     * @param {string} className - A class name of record
-     * @param {object} data - Object of parameters
-     * @param {string} data._id - An ID of record to update
-     * @param {updateDataCallback} callback - The updateDataCallback function
+     * @param {string} className - A class name of record.
+     * @param {object} data - Object of parameters.
+     * @param {string} data._id - An ID of record to update.
+     * @param {updateDataCallback} callback - The updateDataCallback function.
      * @example
      * QB.data.update('GameOfThrones', {
      *     '_id': '53aaa06f535c12cea9007496',
@@ -142,10 +142,10 @@ DataProxy.prototype = {
      */
     update: function(className, data, callback) {
         /**
-         * Callback for QB.data.update(className, data, callback)
+         * Callback for QB.data.update(className, data, callback).
          * @callback updateDataCallback
-         * @param {object} error - The error object
-         * @param {object} response - An object
+         * @param {object} error - The error object.
+         * @param {object} response - An object.
          */
         this.service.ajax({
             'url': Utils.getUrl(config.urls.data, className + '/' + data._id),
@@ -163,14 +163,13 @@ DataProxy.prototype = {
     },
 
     /**
-     * Delete record / records by ID, IDs or criteria (filters) of particular class. <br />
-     * Check out {@link https://docsdev.quickblox.com/rest_api/CustomObjects_API.html#Delete_object official documentaion} to get detailed information.
+     * Delete record/records by ID, IDs or criteria (filters) of particular class({@link https://docs.quickblox.com/docs/js-custom-objects#delete-records read more}).
      * 
      * @memberof QB.data
      * 
-     * @param {string} className - A class name of record
-     * @param {(string|array|object)} requestedData - An ID of record or an array of record's ids or object of criteria rules to delete
-     * @param {deletedDataCallback} callback - The deletedDataCallback function
+     * @param {string} className - A class name of record.
+     * @param {(string|array|object)} requestedData - An ID of record or an array of record's ids or object of criteria rules to delete.
+     * @param {deletedDataCallback} callback - The deletedDataCallback function.
      * 
      * @example
      * var className = 'Movie';
@@ -206,12 +205,12 @@ DataProxy.prototype = {
      */
     delete: function(className, requestedData, callback) {
         /**
-         * Callback for QB.data.delete(className, requestedData, callback)
+         * Callback for QB.data.delete(className, requestedData, callback).
          * @callback deletedDataCallback
-         * @param {object} error - The error object
+         * @param {object} error - The error object.
          * @param {object|null} response
          * @param {array} response.deleted - Array of ids of deleted records. If you delete BY CRITERIA this property will be null.
-         * @param {number} response.deletedCount - count of deleted records.
+         * @param {number} response.deletedCount - Count of deleted records.
          */
         var typesData = {
             id: 1,
@@ -276,21 +275,21 @@ DataProxy.prototype = {
     },
 
     /**
-     * Upload file to file field ({@link https://quickblox.com/developers/Custom_Objects#Upload.2FUpdate_file read more})
+     * Upload file to file field({@link https://docs.quickblox.com/docs/js-custom-objects#files read more}).
      * @memberof QB.data
-     * @param {string} className - A class name to which a new object belongs
-     * @param {object} params - Object of parameters
-     * @param {string} [params.field_name] - The file's field name
-     * @param {string} [params.name] - The file's name
-     * @param {object} [params.file] - File object
-     * @param {uploadFileToDataCallback} callback - The uploadFileToDataCallback function
+     * @param {string} className - A class name to which a new object belongs.
+     * @param {object} params - Object of parameters.
+     * @param {string} [params.field_name] - The file's field name.
+     * @param {string} [params.name] - The file's name.
+     * @param {object} [params.file] - File object.
+     * @param {uploadFileToDataCallback} callback - The uploadFileToDataCallback function.
      */
     uploadFile: function(className, params, callback) {
         /**
-         * Callback for QB.data.uploadFile(className, params, callback)
+         * Callback for QB.data.uploadFile(className, params, callback).
          * @callback uploadFileToDataCallback
-         * @param {object} error - The error object
-         * @param {object} response - The file object
+         * @param {object} error - The error object.
+         * @param {object} response - The file object.
          */
         var data = {
                 field_name: params.field_name,
@@ -316,20 +315,20 @@ DataProxy.prototype = {
     },
 
     /**
-     * Download file from file field by ID ({@link https://quickblox.com/developers/Custom_Objects#Download_file read more})
+     * Download file from file field by ID({@link https://docs.quickblox.com/docs/js-custom-objects#download-file read more}).
      * @memberof QB.data
-     * @param {string} className - A class name of record
-     * @param {object} params - Object of parameters
-     * @param {string} params.field_name - The file's field name
-     * @param {string} params.id - The record's ID
-     * @param {downloadFileFromDataCallback} callback - The downloadFileFromDataCallback function
+     * @param {string} className - A class name of record.
+     * @param {object} params - Object of parameters.
+     * @param {string} params.field_name - The file's field name.
+     * @param {string} params.id - The record's ID.
+     * @param {downloadFileFromDataCallback} callback - The downloadFileFromDataCallback function.
      */
     downloadFile: function(className, params, callback) {
         /**
-         * Callback for QB.data.downloadFile(className, params, callback)
+         * Callback for QB.data.downloadFile(className, params, callback).
          * @callback downloadFileFromDataCallback
-         * @param {object} error - The error object
-         * @param {object} response - The file object
+         * @param {object} error - The error object.
+         * @param {object} response - The file object.
          */
         var result = Utils.getUrl(config.urls.data, className + '/' + params.id + '/file');
         result += '?field_name=' + params.field_name + '&token=' + this.service.getSession().token;
@@ -337,12 +336,12 @@ DataProxy.prototype = {
     },
 
     /**
-     * Return file's URL from file field by ID
+     * Return file's URL from file field by ID.
      * @memberof QB.data
-     * @param {string} className - A class name of record
-     * @param {object} params - Object of parameters
-     * @param {string} params.field_name - The file's field name
-     * @param {string} params.id - The record's ID
+     * @param {string} className - A class name of record.
+     * @param {object} params - Object of parameters.
+     * @param {string} params.field_name - The file's field name.
+     * @param {string} params.id - The record's ID.
      */
     fileUrl: function(className, params) {
         var result = Utils.getUrl(config.urls.data, className + '/' + params.id + '/file');
@@ -351,20 +350,20 @@ DataProxy.prototype = {
     },
 
     /**
-     * Delete file from file field by ID ({@link https://quickblox.com/developers/Custom_Objects#Delete_file read more})
+     * Delete file from file field by ID({@link https://docs.quickblox.com/docs/js-custom-objects#delete-file read more}).
      * @memberof QB.data
-     * @param {string} className - A class name of record
-     * @param {object} params - Object of parameters
-     * @param {string} params.field_name - The file's field name
-     * @param {string} params.id - The record's ID
-     * @param {deleteFileFromDataCallback} callback - The deleteFileFromDataCallback function
+     * @param {string} className - A class name of record.
+     * @param {object} params - Object of parameters.
+     * @param {string} params.field_name - The file's field name.
+     * @param {string} params.id - The record's ID.
+     * @param {deleteFileFromDataCallback} callback - The deleteFileFromDataCallback function.
      */
     deleteFile: function(className, params, callback) {
         /**
-         * Callback for QB.data.deleteFile(className, params, callback)
+         * Callback for QB.data.deleteFile(className, params, callback).
          * @callback deleteFileFromDataCallback
-         * @param {object} error - The error object
-         * @param {object} response - Empty body
+         * @param {object} error - The error object.
+         * @param {object} response - Empty body.
          */
         this.service.ajax({url: Utils.getUrl(config.urls.data, className + '/' + params.id + '/file'), data: {field_name: params.field_name},
             dataType: 'text', type: 'DELETE'}, function(err, result) {

package/src/modules/qbPushNotifications.js

@@ -39,56 +39,56 @@ function SubscriptionsProxy(service){
 SubscriptionsProxy.prototype = {
 
     /**
-     * Create device based subscription (subscribes) ({@link https://docsdev.quickblox.com/rest_api/Push_Notifications_API.html#Create_subscription read more})
+     * Create device based subscription.
      * @memberof QB.pushnotifications.subscriptions
-     * @param {object} params - Object of parameters
-     * @param {string} params.notification_channel - Declare which notification channels could be used to notify user about events. Allowed values: apns, apns_voip, gcm, mpns, bbps and email
-     * @param {object} params.push_token - Object of parameters
-     * @param {string} params.push_token.environment - Determine application mode. It allows conveniently separate development and production modes. Allowed values: evelopment or production
-     * @param {string} [params.push_token.bundle_identifier] - A unique identifier for client's application. In iOS, this is the Bundle Identifier. In Android - package id
-     * @param {string} params.push_token.client_identification_sequence - Identifies client device in 3-rd party service like APNS, GCM/FCM, BBPS or MPNS. Initially retrieved from 3-rd service and should be send to QuickBlox to let it send push notifications to the client
-     * @param {object} params.device - Object of parameters
-     * @param {string} params.device.platform - Platform of device, which is the source of application running. Allowed values: ios, android, windows_phone, blackberry
-     * @param {string} params.device.udid - UDID (Unique Device identifier) of device, which is the source of application running. This must be anything sequence which uniquely identify particular device. This is needed to support schema: 1 User - Multiple devices
-     * @param {createPushSubscriptionCallback} callback - The createPushSubscriptionCallback function
+     * @param {object} params - Object of parameters.
+     * @param {string} params.notification_channel - Declare which notification channels could be used to notify user about events. Allowed values: apns, apns_voip, gcm, mpns, bbps and email.
+     * @param {object} params.push_token - Object of parameters.
+     * @param {string} params.push_token.environment - Determine application mode. It allows conveniently separate development and production modes. Allowed values: evelopment or production.
+     * @param {string} [params.push_token.bundle_identifier] - A unique identifier for client's application. In iOS, this is the Bundle Identifier. In Android - package id.
+     * @param {string} params.push_token.client_identification_sequence - Identifies client device in 3-rd party service like APNS, GCM/FCM, BBPS or MPNS. Initially retrieved from 3-rd service and should be send to QuickBlox to let it send push notifications to the client.
+     * @param {object} params.device - Object of parameters.
+     * @param {string} params.device.platform - Platform of device, which is the source of application running. Allowed values: ios, android, windows_phone, blackberry.
+     * @param {string} params.device.udid - UDID (Unique Device identifier) of device, which is the source of application running. This must be anything sequence which uniquely identify particular device. This is needed to support schema: 1 User - Multiple devices.
+     * @param {createPushSubscriptionCallback} callback - The createPushSubscriptionCallback function.
      */
     create: function(params, callback) {
         /**
-         * Callback for QB.pushnotifications.subscriptions.create(params, callback)
+         * Callback for QB.pushnotifications.subscriptions.create(params, callback).
          * @callback createPushSubscriptionCallback
-         * @param {object} error - The error object
-         * @param {object} response - Array of all existent user's subscriptions
+         * @param {object} error - The error object.
+         * @param {object} response - Array of all existent user's subscriptions.
          */
         this.service.ajax({url: Utils.getUrl(config.urls.subscriptions), type: 'POST', data: params}, callback);
     },
 
     /**
-     * Retrieve subscriptions for the user which is specified in the session token ({@link https://docsdev.quickblox.com/rest_api/Push_Notifications_API.html#Retrieve_subscriptions read more})
+     * Retrieve subscriptions for the user which is specified in the session token.
      * @memberof QB.pushnotifications.subscriptions
-     * @param {listPushSubscriptionCallback} callback - The listPushSubscriptionCallback function
+     * @param {listPushSubscriptionCallback} callback - The listPushSubscriptionCallback function.
      */
     list: function(callback) {
         /**
-         * Callback for QB.pushnotifications.subscriptions.list(callback)
+         * Callback for QB.pushnotifications.subscriptions.list(callback).
          * @callback listPushSubscriptionCallback
-         * @param {object} error - The error object
-         * @param {object} response - Array of all existent user's subscriptions
+         * @param {object} error - The error object.
+         * @param {object} response - Array of all existent user's subscriptions.
          */
         this.service.ajax({url: Utils.getUrl(config.urls.subscriptions)}, callback);
     },
 
     /**
-     * Remove a subscription by its identifier (unsubscribes) ({@link https://docsdev.quickblox.com/rest_api/Push_Notifications_API.html#Remove_subscription read more})
+     * Remove a subscription by its identifier.
      * @memberof QB.pushnotifications.subscriptions
-     * @param {number} id - An id of subscription to remove
-     * @param {deletePushSubscriptionCallback} callback - The deletePushSubscriptionCallback function
+     * @param {number} id - An id of subscription to remove.
+     * @param {deletePushSubscriptionCallback} callback - The deletePushSubscriptionCallback function.
      */
     delete: function(id, callback) {
         /**
-         * Callback for QB.pushnotifications.subscriptions.delete(id, callback)
+         * Callback for QB.pushnotifications.subscriptions.delete(id, callback).
          * @callback deletePushSubscriptionCallback
-         * @param {object} error - The error object
-         * @param {object} response - Empty body
+         * @param {object} error - The error object.
+         * @param {object} response - Empty body.
          */
         var attrAjax = {
             'type': 'DELETE',
@@ -116,38 +116,38 @@ function EventsProxy(service){
 
 EventsProxy.prototype = {
     /**
-     * Create notification event. This request will immediately produce notification delivery (push notification or email) ({@link https://docsdev.quickblox.com/rest_api/Push_Notifications_API.html#Create_event read more})
+     * Create notification event. This request will immediately produce notification delivery (push notification or email) ({@link https://docs.quickblox.com/docs/js-push-notifications#send-push-notifications read more}).
      * @memberof QB.pushnotifications.events
      *
-     * @param {object} params - Object of parameters
-     * @param {string} params.notification_type - Type of notification. Allowed values: push or email
-     * @param {string} params.environment - An environment of the notification. Allowed values: development or production
-     * @param {string} params.message - A payload of event. For push notifications: if event[push_type] not present - should be Base64 encoded text. if event[push_type] specified - should be formatted as described in {@link https://quickblox.com/developers/Messages#Push_Notification_Formats QuickBlox Push Notifications Formats} For email: Base64 encoded text
+     * @param {object} params - Object of parameters.
+     * @param {string} params.notification_type - Type of notification. Allowed values: push or email.
+     * @param {string} params.environment - An environment of the notification. Allowed values: development or production.
+     * @param {string} params.message - A payload of event. For push notifications: if event[push_type] not present - should be Base64 encoded text.
      *
-     * @param {string} [params.push_type] - Push Notification type. Used only if event[notification_type] = push, ignored in other cases. If not present - Notification will be delivered to all possible devices for specified users. Each platform has their own standard format. See {@link https://quickblox.com/developers/Messages#Push_Notification_Formats QuickBlox Push Notifications Formats} for more information. If specified - Notification will be delivered to the specified platform only. Allowed values: apns, apns_voip, gcm, mpns or bbps
-     * @param {string} [params.event_type] - Allowed values: one_shot, fixed_date or period_date. one_shot - a one-time event, which causes by an external object (the value is only valid if the 'date' is not specified). fixed_date - a one-time event, which occurs at a specified 'date' (the value is valid only if the 'date' is given). period_date - reusable event that occurs within a given 'period' from the initial 'date' (the value is only valid if the 'period' specified). By default: fixed_date, if 'date' is specified. period_date, if 'period' is specified. one_shot, if 'date' is not specified
-     * @param {string} [params.name] - The name of the event. Service information. Only for your own usage
-     * @param {number} [params.period] - The period of the event in seconds. Required if the event[event_type] = period_date. Possible values: 86400 (1 day). 604800 (1 week). 2592000 (1 month). 31557600 (1 year)
-     * @param {number} [params.date] - The date of the event to send on. Required if event[event_type] = fixed_date or period_date. If event[event_type] = fixed_date, the date can not be in the pas
+     * @param {string} [params.push_type] - Push Notification type. Used only if event[notification_type] = push, ignored in other cases. If not present - Notification will be delivered to all possible devices for specified users. Each platform has their own standard format. If specified - Notification will be delivered to the specified platform only. Allowed values: apns, apns_voip, gcm, mpns or bbps.
+     * @param {string} [params.event_type] - Allowed values: one_shot, fixed_date or period_date. one_shot - a one-time event, which causes by an external object (the value is only valid if the 'date' is not specified). fixed_date - a one-time event, which occurs at a specified 'date' (the value is valid only if the 'date' is given). period_date - reusable event that occurs within a given 'period' from the initial 'date' (the value is only valid if the 'period' specified). By default: fixed_date, if 'date' is specified. period_date, if 'period' is specified. one_shot, if 'date' is not specified.
+     * @param {string} [params.name] - The name of the event. Service information. Only for your own usage.
+     * @param {number} [params.period] - The period of the event in seconds. Required if the event[event_type] = period_date. Possible values: 86400 (1 day). 604800 (1 week). 2592000 (1 month). 31557600 (1 year).
+     * @param {number} [params.date] - The date of the event to send on. Required if event[event_type] = fixed_date or period_date. If event[event_type] = fixed_date, the date can not be in the pas.
      *
-     * @param {object} [params.user] - User's object of parameters
-     * @param {number[]} [params.user.ids] - Notification's recipients - should contain a string of users' ids divided by commas
-     * @param {object} [params.user.tags] - User's object of tags
-     * @param {string[]} [params.user.tags.any] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) must have at least one tag that specified in the list
-     * @param {string[]} [params.user.tags.all] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) must exactly have only all tags that specified in list
-     * @param {string[]} [params.user.tags.exclude] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) mustn't have tags that specified in list
+     * @param {object} [params.user] - User's object of parameters.
+     * @param {number[]} [params.user.ids] - Notification's recipients - should contain a string of users' ids divided by commas.
+     * @param {object} [params.user.tags] - User's object of tags.
+     * @param {string[]} [params.user.tags.any] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) must have at least one tag that specified in the list.
+     * @param {string[]} [params.user.tags.all] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) must exactly have only all tags that specified in list.
+     * @param {string[]} [params.user.tags.exclude] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) mustn't have tags that specified in list.
      *
-     * @param {object} [params.external_user] - External user's object of parameters
-     * @param {number[]} [params.external_user.ids] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) mustn't have tags that specified in list
+     * @param {object} [params.external_user] - External user's object of parameters.
+     * @param {number[]} [params.external_user.ids] - Notification's recipients - should contain a string of tags divided by commas. Recipients (users) mustn't have tags that specified in list.
      *
-     * @param {createPushEventCallback} callback - The createPushEventCallback function
+     * @param {createPushEventCallback} callback - The createPushEventCallback function.
      */
     create: function(params, callback) {
         /**
-         * Callback for QB.pushnotifications.events.create(params, callback)
+         * Callback for QB.pushnotifications.events.create(params, callback).
          * @callback createPushEventCallback
-         * @param {object} error - The error object
-         * @param {object} response - An event object
+         * @param {object} error - The error object.
+         * @param {object} response - An event object.
          */
         this.service.ajax({
             'url': Utils.getUrl(config.urls.events),
@@ -160,19 +160,20 @@ EventsProxy.prototype = {
         }, callback);
     },
 
-    /** Get list of events which were created by current user ({@link https://docsdev.quickblox.com/rest_api/Push_Notifications_API.html#Retrieve_events read more})
+    /** 
+     * Get list of events which were created by current user.
      * @memberof QB.pushnotifications.events
-     * @param {object} params - Object of parameters
-     * @param {number} [params.page=1] - Used to paginate the results when more than one page of events retrieved
-     * @param {number} [params.per_page=10] - The maximum number of events to return per page, if not specified then the default is 10
-     * @param {listPushEventsCallback} callback - The listOfFilesCallback function
+     * @param {object} params - Object of parameters.
+     * @param {number} [params.page=1] - Used to paginate the results when more than one page of events retrieved.
+     * @param {number} [params.per_page=10] - The maximum number of events to return per page, if not specified then the default is 10.
+     * @param {listPushEventsCallback} callback - The listOfFilesCallback function.
      */
     list: function(params, callback) {
         /**
-         * Callback for QB.pushnotifications.events.list(params, callback)
+         * Callback for QB.pushnotifications.events.list(params, callback).
          * @callback listPushEventsCallback
-         * @param {object} error - The error object
-         * @param {object} response - An array of events' objects
+         * @param {object} error - The error object.
+         * @param {object} response - An array of events' objects.
          */
         if (typeof params === 'function' && typeof callback ==='undefined') {
             callback = params;
@@ -182,47 +183,50 @@ EventsProxy.prototype = {
         this.service.ajax({url: Utils.getUrl(config.urls.events), data: params}, callback);
     },
 
-    /** Retrieve an event by ID ({@link https://docsdev.quickblox.com/rest_api/Push_Notifications_API.html#Retrieve_event read more})
+    /** 
+     * Retrieve an event by ID.
      * @memberof QB.pushnotifications.events
-     * @param {number} id - An id of event to retrieve
-     * @param {getPushEventByIdCallback} callback - The getPushEventByIdCallback function
+     * @param {number} id - An id of event to retrieve.
+     * @param {getPushEventByIdCallback} callback - The getPushEventByIdCallback function.
      */
     get: function(id, callback) {
         /**
-         * Callback for QB.pushnotifications.events.get(id, callback)
+         * Callback for QB.pushnotifications.events.get(id, callback).
          * @callback getPushEventByIdCallback
-         * @param {object} error - The error object
-         * @param {object} response - An array of events' objects
+         * @param {object} error - The error object.
+         * @param {object} response - An array of events' objects.
          */
         this.service.ajax({url: Utils.getUrl(config.urls.events, id)}, callback);
     },
 
-    /** Delete an event by ID ({@link https://docsdev.quickblox.com/rest_api/Push_Notifications_API.html#Delete_event read more})
+    /** 
+     * Delete an event by ID.
      * @memberof QB.pushnotifications.events
-     * @param {number} id - An id of event to delete
-     * @param {deletePushEventByIdCallback} callback - The deletePushEventByIdCallback function
+     * @param {number} id - An id of event to delete.
+     * @param {deletePushEventByIdCallback} callback - The deletePushEventByIdCallback function.
      */
     delete: function(id, callback) {
         /**
-         * Callback for QB.pushnotifications.events.delete(id, callback)
+         * Callback for QB.pushnotifications.events.delete(id, callback).
          * @callback deletePushEventByIdCallback
-         * @param {object} error - The error object
-         * @param {object} response - Empty body
+         * @param {object} error - The error object.
+         * @param {object} response - Empty body.
          */
         this.service.ajax({url: Utils.getUrl(config.urls.events, id), dataType: 'text', type: 'DELETE'}, callback);
     },
 
-    /** Retrieve an event's status by ID
+    /** 
+     * Retrieve an event's status by ID
      * @memberof QB.pushnotifications.events
-     * @param {number} id - An id of event to retrieve its status
-     * @param {getPushEventStatusByIdCallback} callback - The getPushEventStatusByIdCallback function
+     * @param {number} id - An id of event to retrieve its status.
+     * @param {getPushEventStatusByIdCallback} callback - The getPushEventStatusByIdCallback function.
      */
     status: function(id, callback) {
         /**
-         * Callback for QB.pushnotifications.events.status(id, callback)
+         * Callback for QB.pushnotifications.events.status(id, callback).
          * @callback getPushEventStatusByIdCallback
-         * @param {object} error - The error object
-         * @param {object} response - An array of events' objects
+         * @param {object} error - The error object.
+         * @param {object} response - An array of events' objects.
          */
         this.service.ajax({url: Utils.getUrl(config.urls.events, id + '/status')}, callback);
     }