Get configuration

The typical process for tracking events involves two steps. In this section, we’ll focus on how to retrieve API details and gather all the necessary information. Before proceeding, ensure that your application is configured as outlined in the "Configuring you application" section.

Get the configuration

Let's establish some of our data that will be used in the following example:

• YOUR_CONFIG_URL: https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/applications/4640861f-f29b-48b6-8baa-a0f23249cf77/signature/2024-11-26T15-00-00_88eb9214e4

Request

curl -X GET "YOUR_CONFIG_URL" \
-H "Content-Type: application/json"

Response (200 OK)

{
    "applicationId": "4640861f-f29b-48b6-8baa-a0f23249cf77",
    "workspaceId": "a1405560-c8d3-4b1a-877d-3f449ad95352",
    "apiEndpoint": "https://api.bird.com",
    "allowedDomains": [
        "myapplication.com"
    ],
    "allowedAppBundles": [
        ""
    ],
    "tracking": {
        "connectorId": "a1405560-c8d3-4b1a-877d-3f449ad95352",
        "enabled": true,
        "writeKey": "a1405560-c8d3-4b1a-877d-3f449ad95352",
        "endpoint": "https://capture.eu-west-1.api.bird.com/tracking/track",
        "trackPageViews": true,
        "anonymousTracking": "enqueue",
        "trackLifecycleEvents": true
    },
    "pushNotifications": {
        "enabled": false,
        "connectorId": "00000000-0000-0000-0000-000000000000",
        "endpoint": "https://capture.eu-west-1.api.bird.com/push-notifications"
    },
    "appInbox": {
        "enabled": false,
        "connectorId": "00000000-0000-0000-0000-000000000000",
        "channelId": "00000000-0000-0000-0000-000000000000",
        "endpoint": "https://capture.eu-west-1.api.bird.com/ app-inbox"
    }
}

You will need the following information from the response for the subsequent steps:

• workspaceId

• tracking.endpoint

• tracking.writeKey

We recommend retrieving the configuration at the beginning of the session and caching the response for the entire tracking session. Once you have this information, you can move on to the next step: Track events.