App

API v1

With the App API, you can:

• View your list of apps
• Upload bids

List apps

Return the list of apps for the current user's organization.

POST /management/v1/apps

Request

{
  "page": {
    "offset": integer,
    "limit": integer,
  }
}

Name	Type	Description
page.offset	uint	Number of apps to skip for this filter
page.limit	uint	Maximum number of apps to return

Responses

200

{
  "results": [
    {
      "createdAt": timestamp,
      "id": integer,
      "name": string,
      "bundleId": string,
      "platform": string,
      "storeId": string,
      "updatedAt": timestamp
    }
  ]
}

Name	Type	Description
createdAt	timestamp	The date and time in UTC at which the app was created. This timestamp doesn't include the timezone.
id	uint	justtrack's identifier for the app
name	string	The name of the app
bundleId	string	The package of the app
platform	string	The app's platform; Possible values are: android, ios, and web
storeId	string	The identifier of the app in the app store
updatedAt	timestamp	The date and time in UTC at which the app was last updated. This timestamp doesn't include the timezone.

Create app

Create an app.

POST /management/v1/app

Request

{
    "name": string,
    "platform": string,
    "storeId": string,
    "iconUrl": string,
    "bundleId": string
}

Name	Type	Description
name	string	The name of the app
platform	string	The app's platform; Possible values are: android, ios, and web
storeId	string	The identifier of the app in the app store
iconUrl	string	Icon URL taken from store
bundleId	string	The package of the app

info

We validate the following constraints when creating an app:

• The bundle ID must be used only by you as a customer
• The tuple (bundle ID, platform) must be unique
• The tuple (name, platform) must be unique
• The store ID must be unique

Responses

200

{
    "createdAt": timestamp,
    "id": integer,
    "name": string,
    "bundleId": string,
    "platform": string,
    "storeId": string,
    "updatedAt": timestamp,
    "apiKey": string
}

Name	Type	Description
createdAt	timestamp	The date and time in UTC at which the app was created. This timestamp doesn't include the timezone.
id	uint	justtrack's identifier for the app
name	string	The name of the app
bundleId	string	The package of the app
platform	string	The app's platform; Possible values are: android, ios, and web
storeId	string	The identifier of the app in the app store
updatedAt	timestamp	The date and time in UTC at which the app was last updated. This timestamp doesn't include the timezone.
apiKey	string	The API key used to authenticate calls of the justtrack SDK. Use it during SDK setup.

API v0

warning

This is the documentation for API v0, which is no longer maintained.

For up-to-date documentation, see the latest version.

List apps

List app return the list of apps for the current user's organization.

curl --location -X POST 'https://api.justtrack.io/management/v0/apps' \
-H 'X-API-KEY: <API KEY>'

Response

{
  "result": [
    {
      "id": int,
      "platformId": int,
      "packageId": string,
      "storeId": string,
      "name": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}

Name	Type	Description
id	int	ID of the app
platformId	int	The app's platform; one of: 1 for Android 2 for iOS 3 for Web
packageId	string	Application package ID
storeId	string	Application store ID as used by the Apple or Google App Store
name	string	Name of the app
createdAt	string	The date of app creation
updatedAt	string	The date of the latest app update

Create app

With this API, you can create an App.

curl -X POST -H X-API-Key: <API_KEY>
https://api.justtrack.io/management/v0/app

Request

The general request to the Create App API looks like:

{
    "name": "test 123",
    "platformId": 1,
    "storeId": "gg.sunday.cate",
    "iconLink": "https://play-lh.googleusercontent.com/If5wCREVhk1ibdZd8g67oShl_Vnm0qyx3OayiBl7Sm3UGr_74_0ZrWEmLXo5XesrGw=w480-h960",
    "packageId": "packageid",
    "networkAttributes": [
        {
            "attribute": {
                "id": 1
            },
            "value": "456"
        }, {
            "attribute": {
                "id": 2
            },
            "value": "789"
        }
    ]
}

General parameters

Name	Type	Description
name	string	The name of the App to create
platformId	int	The App's platform; one of: 1 for Android 2 for iOS 3 for Web
storeId	string	Unique ID of the application in the store
iconLink	string	Icon URL taken from store
packageId	int	ID of package

info

We validate the following constraints when creating an app: monetisation

• the package ID must be used only by you as a customer
• the tuple (package ID, platform ID) must be unique
• the tuple (name, platform ID) must be unique
• the store ID must only be used once

Response

General fields

{
    "id": 123,
    "name": "test 123",
    "platformId": 1,
    "apiToken": "abcd1234"
}

Name	Type	Description
Id	string	Unique ID of the App in justtrack
name	string	The name of the App to create
platformId	int	The app's platform. One of: 1 for Android 2 for iOS 3 for Web
apiToken	string	The API token for the Partner.