API

Endpoints

The following API endpoints to the dashboard are available:

Method	Base URL	Request Type
Add App	/validator/api/apps/add	POST

caution

API requests to the dashboard are rate-limited as a security measure. If your request was throttled (HTTP status 429), please try again a minute later.

Authentication

The HEADER of your request should contain the following fields and values:

Field	Description
X-Auth-Email	The email you registered your account with.
X-Auth-Key	The API Key found in your Profile tab at the top.

Add App

Call this function in order to automate the app creation process on our platform. More details on the field values can be found in the App Setup documentation.

Please note that the subscription plan cannot be passed in, as it requires manual payment confirmation. Apps added via the API will start on the FREE plan automatically.

Request

JSON encoded values in request body.

Field	Description
name	Required. The name of your new app.
user_mode	User Behaviour value as number: Disabled = 0 Transfer = 1 Block = 2 Alias = 3
bid_google bid_apple	The corresponding Bundle IDs.
key_google key_apple	License Keys in a JSON-compatible format, meaning all spaces, line breaks or \n should be replaced with \\n. For example, if you are using a string escaper tool, you would have to pass in your original Google key once and the original Apple key twice.
acc_google acc_apple	Account IDs. Since the Apple ID consists of two values, concatenate them using a semicolon.

Response

JSON encoded values in response body.

Success: HTTP Status 200.
Failed: HTTP Status 400, 405, 429.

Field	Description
success	true or false.
id	The app ID created.
error	Description of the error in case success = false.

Example

Request

{
  "name":"Your new App name",
  "user_mode":0,
  "bid_google":"yourAndroidBundleID",
  "bid_apple":"yourAppleBundleID",
  "key_google":"-----BEGIN PRIVATE KEY-----\\n.....\\n-----END PRIVATE KEY-----\\n",
  "key_apple":"-----BEGIN PRIVATE KEY-----\\.....\\n-----END PRIVATE KEY-----", 
  "acc_google":".....gserviceaccount.com",
  "acc_apple":"yourIssuerKey;yourKIDKey"
}

Response

{
  "success":true,
  "id":"abcdefghijklm123"
}