REST API Setup

Adding API Key to Request

To authenticate your requests to the Netmera REST API, you need to include your REST API key in the request headers. Follow the steps below to obtain your REST API key and add it to the request headers:

1. Retrieve your REST API key from the Netmera panel:

   • Go to Developers -> API in the Netmera panel.

   • Copy your REST API key from the provided field. Note that only the REST API key should be used for making requests via the REST API.

2. Include the API key in the request headers using the "X-netmera-api-key" key. Here's an example:

curl -X POST \
-H "X-netmera-api-key: REST_API_KEY_SHOULD_BE_HERE" \
-H "Content-Type: application/json" \
-d '[
        ......

⚠️ Make sure to set the "Content-Type" header to "application/json" for JSON requests.

What is External ID (extId)?

For many requests, you will need to provide an external ID (extId). The external ID is a unique identifier for a user in your system. It should also be unique in the Netmera system. For example, if a user is using your app on both a smartphone and a tablet, you can use the same external ID to identify them. This ensures that only one user with multiple installations is created in the Netmera system.

User: The end-user who actually uses the application, identified by a unique ID.

Installation: An app installation on a specific device, such as "John's Fancy app on his iPhone" or "John's Fancy app on his iPad".