customizeAPIRequest(customizeAPIRequestFunction: Function)

[starting from version: 2.8]

This API call allows customizing the request before it is sent to a server. Only for "api" data source type.

Please note, you can define customizeAPIRequest in two ways:

1. as a regular API call: flexmonster.customizeAPIRequest(customizeAPIRequestFunction);
2. as an initialization parameter: new Flexmonster({customizeAPIRequest: customizeAPIRequestFunction, ...})

Parameters

customizeAPIRequestFunction function or null in case you do not need to change anything. Data passed to the customizeAPIRequestFunction:

• requestBody – Object. The object that contains the request’s body and through which the request can be customized. Has the following properties:
  • requestHeaders – Object. Allows you to add custom request headers. This object consists of "key": "value" pairs, where "key" is a header’s name and "value" is its value.
    The requestHeaders object is either empty or containing the request headers added in the Data Source Object in the report.
  After customization, Flexmonster adds the contents of requestHeaders to the headers of the request. Changes made in requestBody are added to the request’s body.

Example

Adding custom request headers:

function customizeAPIRequestFunction(req) {
    req.requestHeaders = {
        "customHeader1": "This is the first custom request header",
        "customHeader2": "This is the second custom request header"
    };
    console.log(req);
}

Check out a live sample on JSFiddle.