App Management API

The following document defines and provides samples for Premium Publisher API calls for the management of apps within Kochava.

---

Get All Apps API

The Get All API call provides a list of apps that your account has ownership of.

NOTE: This will not return Apps Running Media if you are a Publisher or Premium Publisher.

 

Request Parameters:

pageToken —

By default this API will return all of your account owned apps. You can trigger pagination by specifying “1” for the pageToken and doing so returns 50 results per page. previousToken and nextToken is used to navigate backward and forward respectively.

Type —

String

Required —

No

 

Response Parameters:

nextToken —

Used to retrieve the next page of results. When the last page of data is reached then NULL will be returned.

Type —

String

previousToken —

Used to retrieve the previous page of results. When the first page of data is reached then NULL will be returned.

Type —

String

 

Full Detail Data Sample Request:

GET: https://apps.api.kochava.com/apps?app_selector=false
Header: Authentication-Key: {MyUserAPIKey}

 

Sample Response:

 

Limited Detail Sample Request:

GET: https://apps.api.kochava.com/apps?app_selector=true
Header: Authentication-Key: {MyUserAPIKey}

 

Sample Response:

---

Get Single App

This API is used to retrieve a single app by providing the API the numerical app ID to look up.

 

Sample Request Without App Store Information:

GET: https://apps.api.kochava.com/app/app_id?app_store_info=false
Header: Authentication-Key: {MyUserAPIKey}

 

NOTE: If no flag is provided, the app store information will not be included by default.

 

Sample Response:

 

Sample Request With App Store Information:

GET: https://apps.api.kochava.com/app/app_id?app_store_info=true
Header: Authentication-Key: {MyUserAPIKey}

 

Sample Response:

---

Verify App Exists

This API is used to check if an app exists by providing the API the numerical app ID (1234 in this case) to look up.

 

Sample Request:

 

Sample Response:

---

Create New App

This API is used to create a new app under your account by providing it a JSON definition of the app.

 

Currently Accepted Platform — SDK Integration Type Values:

 

NOTE: The name of the app has to be unique across the entire Kochava system.

 

Sample Request:

POST: https://apps.api.kochava.com/app
Header: Authentication-Key: {MyUserAPIKey}

 

Sample Body:

 

Sample Response:

---

Updating Existing App

This API is used to update an existing app under your account by providing it a JSON definition of the app.

 

Sample Request:

PATCH: https://apps.api.kochava.com/app/app_id
Header: Authentication-Key: {MyUserAPIKey}

 

Sample Body: