# Configuring Web API Data Source ActiveReports provides a Visual Studio integrated report designer, rich controls to create and modify reports, and interactive report viewers to preview the reports. ## Content If you selected the **JSON API** data source in the **Web API** section, the next screen of the report wizard allows you to connect your report to data provided by a web service via an HTTP request. This type of data source is particularly useful when working with RESTful APIs or other web-based services. The following sections describe the connection settings in detail. ### Fixed and Dynamic Settings Connection settings can either be fixed or dynamic: * **Fixed Settings**: These are hard-coded values that remain constant and can only be modified at design-time. * **Dynamic Settings**: These allow you to supply values programmatically or interactively, giving more flexibility during runtime or when different users view the report. To make a setting dynamic, click the **Parameter...** or **Insert parameter...** link near the setting name: ![General Section in Configure Web API Request](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/configure-web-api-request.png) This will open the **Parameters** dialog: ![Add Parameter for Web API Request](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/configure-web-api-request-parameters.png) Here, you can re-use an existing parameter or create a new one by clicking the **Add** button. The following properties can be configured: * **Name**: The parameter name used as a reference in the connection settings. You’ll need this name to supply its value via code if you choose to do so. * **Type**: The data type of the parameter. You can select from **Boolean**, **DateTime**, **Integer**, **Float**, and **String**. * **Testing Value**: The value used at design-time to test the connection. * **Input Source**: Choose **Programmatic** to supply the parameter values via your application code, or **Interactive** to allow report readers to provide the parameter values. When you can click the **OK** button and the reference to the selected parameter will be inserted in the connection setting, for example, the **URL** will be set to **{url}**. ### Advantages of Dynamic Settings Dynamic settings offer flexibility, especially in environments where connection details might change or where different users require different settings. For example, you might want to use different URLs depending on the current environment. ### Configuring JSON API Connection ![Configure Web API Request screen](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/configure-web-api-request2.png) ### General Settings * **URL**: Enter the full URL of the Web API endpoint that will provide the data for your report. You can make the entire URL, or part of it, dynamic by using the **Insert parameter...** link as described above. ### HTTP Method Select the HTTP method to be used for the API request. The available options are: * **GET**: This method is used to retrieve data from the API. It is the default and most commonly used method for data sources. * **POST**: This method is used to send data to the server, along with the request. When this option is selected, the POST Body field becomes available. * **POST Body**: If the **POST** method is selected, this field is used to specify the content of the HTTP request body. You can make the entire POST Body, or part of it, dynamic by using the **Insert parameter...** link as described above. ### HTTP Headers: Click on the **HTTP Headers...** button to add custom headers to the API request. This might include headers for authentication (e.g., Bearer tokens), content type (e.g., **application/json**), or other necessary metadata required by the API. You can make the header value dynamic by using the **Parameter** link as described above. ![Add Custom HTTP Headers to Web API Request](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/configure-http-headers.png) ### Test the API Request Before finalizing the configuration, it's important to test the API request to ensure it is functioning as expected. Click the **Test Request** button and check the message in the popup dialog. If the request was configured correctly, the message will look like this: ![Success Message to Adding Custom Headers to Web API Request](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/configure-http-headers-success.png) If the request was not configured properly, the error message will be displayed, and you can click the **Details >>** button for more information: ![Error Message to Adding Custom Headers to Web API Request](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/configure-http-headers-error.png) ### Proceeding to Next Steps Once you have configured the connection, click **Next >** to proceed to the [Configure JSON Queries](/activereportsnet/docs/v19.2/report-authors/using-report-wizard/configuring-data-queries) step of the report wizard.