---
description: >-
  Steps on how to get started and setting up local environment for development
  and testing.
---

# Developers: Getting started

### go to [referral.qwestive.io](https://referral.qwestive.io/) and select your project

<figure><img src="https://668992694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbndaLy2Nitc7mjqZbv1m%2Fuploads%2F0dB5hQIdgRB1GZcNZbya%2FScreenshot%202023-04-25%20at%201.02.02%20PM.png?alt=media&#x26;token=4c16ec5e-25d7-42c1-9f5b-61ebb69693cd" alt=""><figcaption><p>referral.qwestive.io landing page</p></figcaption></figure>

### &#x20;make sure you can access admin section

<figure><img src="https://668992694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbndaLy2Nitc7mjqZbv1m%2Fuploads%2FCQPi1fzCO0mDXeeEMIgO%2FScreenshot%202023-04-25%20at%201.06.16%20PM.png?alt=media&#x26;token=94b14b6a-b1d4-4684-9a52-013f847fae7b" alt=""><figcaption><p>admin section from left sidebar</p></figcaption></figure>

### go to API settings to access project level api keys

* Copy `ProjectId` will be used in SDK initialization and server-side API
* Copy `API key` for client-side SDK purpose
* Copy `API secret Key` for server-side APIs
* Add client-side app's domain, also localhost while testing in development

<figure><img src="https://668992694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbndaLy2Nitc7mjqZbv1m%2Fuploads%2FGXvFwz1fyTvbGfa8vDPn%2FScreenshot%202023-04-25%20at%201.09.36%20PM.png?alt=media&#x26;token=624a8778-a84b-410f-a4ad-549f6a28b3ec" alt=""><figcaption><p>API settings page</p></figcaption></figure>

These values will be required while using our tracking SDK or embedUI SDK or calling our server-side APIs.

<table><thead><tr><th width="346">Parameter</th><th width="401.3333333333333">Description</th></tr></thead><tbody><tr><td><strong>projectId</strong></td><td>Unique id for the project</td></tr><tr><td><strong>apiKey</strong></td><td>Public api key to be used to from tracking SDK and embedUI SDK (client-side only)</td></tr><tr><td><strong>secretApiKey</strong></td><td>Secret api key to be used for calling APIs directly from a server where it is stored securely (server-side only)</td></tr></tbody></table>

{% hint style="info" %}
Please note to **add your web app's domain or localhost in allowed domains list** for authorization, where SDK will be integrated or initialized from&#x20;

Once, the integration has been completed and tested, it can be removed from the list.
{% endhint %}

Few other parameters like **project-key** and **campaignId** will be required for EmbedUI:

| Parameter       | Description                                                                         |
| --------------- | ----------------------------------------------------------------------------------- |
| **project-key** | project-key is the subdomain of the project assigned within qwestive's referral app |
| **campaignId**  | Unique id for the campaign within the project                                       |

1. Go to qwestive's referral [app](https://referral.qwestive.io/) and select your project
2. From project page, select specific campaign which you want to display in embedUI by default
3. Now, copy the url from the navigation bar of your browser, it should look something like this: "**https://**<mark style="color:blue;">**test.referral**</mark>**.qwestive.io/referral/**<mark style="color:blue;">**uPqB6kNJwd6SXVsXIVTa**</mark>**&#x20;".**
4. &#x20;Here, **test.referral** is <mark style="color:blue;">**project-key**</mark> and **uPqB6kNJwd6SXVsXIVTa** is <mark style="color:blue;">**campaignId**</mark>
