Xtremepush

https://docs.xtremepush.com/
Admin
Xtremepush is an all-in-one customer engagement, personalisation, and data platform designed to...
Tokens:294,274
Snippets:3,858
Trust Score:9.7
Update:2 months ago
Show doc for...
Tokens:
Raw
### Perform Magento setup and deployment

Source: https://docs.xtremepush.com/docs/magento-2

Execute system upgrades, dependency injection compilation, and static content deployment after module installation.

```shell
sudo php -d memory_limit=-1 bin/magento setup:upgrade
sudo php -d memory_limit=-1 bin/magento setup:di:compile
sudo php -d memory_limit=-1 bin/magento setup:static-content:deploy -f
```

--------------------------------

### Enable session start tracking

Source: https://docs.xtremepush.com/docs/android-events

Configure the PushConnector to track session starts by calling setEnableStartSession before initialization.

```java
// INITIALISE THE XTREMEPUSH CONNECTOR HERE
mPushConnector = new PushConnector.Builder("XTREME_PUSH_APP_KEY", "GOOGLE_PROJECT_NUMBER")
  .setEnableStartSession(true)
  .create(this);
```

--------------------------------

### Install Plugin with Attribution Support

Source: https://docs.xtremepush.com/docs/phonegap

Use this command to install a version of the plugin that includes IDFA and Android ID collection frameworks.

```bash
cordova plugin add https://github.com/xtremepush/XtremePush-Phonegap#master+attributions
```

--------------------------------

### List Devices Request Examples

Source: https://docs.xtremepush.com/apidocs/list-2

Examples of JSON request bodies for filtering devices by creation time or retrieving the most recent device.

```json
{
  "apptoken": "YOUR_APPTOKEN",
  "condition": [
    [
      "create_time",
      ">=",
      "1420070400"
    ]
  ],
  "offset": "0",
  "limit": "50"
}
```

```json
{
  "apptoken": "YOUR_APPTOKEN",
  "order": "id DESC",
  "offset": "0",
  "limit": "1"
}
```

--------------------------------

### Install CocoaPods dependencies

Source: https://docs.xtremepush.com/docs/ios-sdk-import

Run this command in your terminal to install the specified pods.

```bash
pod install
```

--------------------------------

### Create segment response examples

Source: https://docs.xtremepush.com/apidocs/create-segment

Examples of successful and failed responses when creating a segment.

```json
{
  "code": "200",
  "success": "True",
  "message": "Segment successfully created",
  "model": {
    "id": "SEGMENT_ID",
    "project_id": "PROJECT_ID",
    "title": "Test",
    "conditions": {
      "0": {
        "0": [
          "tags",
          "=",
          "15_01_04",
          [
            "hits",
            ">",
            "5"
          ],
          [
            "daterange",
            "between",
            "2015-01-01 to 2015-01-30",
            "2015-01-01",
            "2015-01-30"
          ]
        ],
        "1": [
          "app_downloaded",
          null,
          null,
          [
            "days_ago",
            ">",
            null,
            null,
            null,
            "10"
          ]
        ],
        "2": [
          "country",
          "=",
          "IE"
        ],
        "operator": "AND"
      },
      "operator": "AND"
    }
  }
}
```

```json
{
  "code": "400",
  "success": "False"
}
```

--------------------------------

### Campaign info response example

Source: https://docs.xtremepush.com/docs/api-data-monitor

Example JSON response for an active campaign template containing push content.

```JSON
{
    "success": true,
    "code": 200,
    "model": {
        "active": 0,
        "messages": {
            "1": {
                "push_text": "Hi {{first_name}}, {{amount}} has been debited from your account. Tap here if you did not approve this."
            },
            "2": {
                "push_text": "Hi {{first_name}}, {{amount}} has been debited from your account. Tap here if you did not approve this."
            },
            "3": {
                "push_text": null
            },
            "6": {
                "push_text": null
            },
            "4": [],
            "7": [],
            "8": [],
            "9": [],
            "10": [],
            "11": []
        }
    }
}
```

--------------------------------

### List User Profiles Request Examples

Source: https://docs.xtremepush.com/apidocs/list-1

Examples of JSON request bodies for filtering and paginating user profiles.

```json
{
  "apptoken": "YOUR_APPTOKEN",
  "condition": [
    [
      "email_addressable",
      "=",
      "0"
    ]
  ],
  "limit": "50",
  "offset": "0"
}
```

```json
{
  "apptoken": "YOUR_APPTOKEN",
  "select": [
    "email"
  ],
  "condition": [
    [
      "email_subscription",
      "=",
      "0"
    ],
    [
      "email_addressable",
      "=",
      "1"
    ],
    [
      "email",
      "is not",
      null
    ]
  ],
  "order": [
    "id ASC",
    "id"
  ],
  "limit": "50",
  "offset": "0"
}
```

--------------------------------

### List list items response examples

Source: https://docs.xtremepush.com/apidocs/list-list-items

Examples of successful and error responses returned by the /list/list-item endpoint.

```json
{
  "success": "True",
  "code": "200",
  "data": [
    {
      "list_id": "3621214",
      "value": "user1"
    },
    {
      "list_id": "3621214",
      "value": "user2"
    }
  ]
}
```

```json
{
  "success": "False",
  "code": "400",
  "message": "General error information",
  "errors": [
    {
      "text": [
        "Detailed information about the specific error"
      ]
    }
  ]
}
```

--------------------------------

### Placeholder Token Example

Source: https://docs.xtremepush.com/docs/realtime-sport-updates

Example of a dynamic placeholder token used to pull data from the incoming feed.

```text
{{ payload.event.home_score }}
```

--------------------------------

### List User Profiles Response Examples

Source: https://docs.xtremepush.com/apidocs/list-1

Examples of successful and error response bodies for the list profile request.

```json
{
  "success": "True",
  "code": "200",
  "data": [
    {
      "id": "11eb0ca1064e5d178bc7061c72c7ac00",
      "email": "info@example.com",
      "email_addressable": "1",
      "email_subscription": "1",
      "timezone": "Europe/Dublin"
    }
  ]
}
```

```json
{
  "success": "False",
  "code": "400",
  "message": "General error information"
}
```

--------------------------------

### Push delivery error response example

Source: https://docs.xtremepush.com/docs/api-data-monitor

Example response showing a delivery failure due to application uninstallation.

```JSON
{
  "code": 200,
  "success": true,
  "data": [{
    "action_id": 759147,
    "campaign_id": 245624,
    "create_time": 1464355910, 
    "device_id": 459923, 
    "error_message": "Application is Uninstalled"
  }],
}
```

--------------------------------

### Request body example

Source: https://docs.xtremepush.com/apidocs/list-segments

Example of the JSON body required for the request, including the mandatory apptoken and optional pagination parameters.

```json
{
 "apptoken": "string",
 "limit": 1,
 "offset": 1
}
```

--------------------------------

### Install Xtremepush CLI

Source: https://docs.xtremepush.com/docs/react-native

Add the Xtremepush CLI to your project using npm or yarn.

```bash
npm install xtremepush-react-native-cli
```

```bash
yarn add xtremepush-react-native-cli
```

--------------------------------

### Create an iOS Send Now Campaign with Conditions

Source: https://docs.xtremepush.com/reference/campaign-model

Example of a POST request to create a campaign with a specific payload and attribute-based segmentation condition.

```bash
curl --request POST \
  --url https://external-api.xtremepush.com/api/external/create/campaign \
  --header 'content-type: application/json' \
  --data '{
    "apptoken": "YOUR_APPTOKEN",
    "title": "El Clasico",
    "ios_push": 1,
    "ios_push_sandbox": 1,
    "push_text": "1-0! Messi scores.",
    "payload_add": [
      {
        "key": "score",
        "value": "1-0"
      }
    ],
    "conditions": {
      "operator": "AND",
      "0": {
        "operator": "AND",
        "0": [
          "tags_attribute",
          "=",
          "live_scores",
          [
            "value",
            "=",
            "on"
          ]
        ]
      }
    }
  }'
```

--------------------------------

### Initialize Custom HTML Configuration

Source: https://docs.xtremepush.com/docs/in-app-custom-html

Example of applying multiple configurations and initializing the SDK within a script block.

```HTML
<script type="text/javascript">
InAppMessage.hideStatusBar = false;
InAppMessage.animationSlide = "from-left";
InAppMessage.lockOrientation = "portrait";
InAppMessage.init();
</script>
```

--------------------------------

### Match Started Campaign Content

Source: https://docs.xtremepush.com/docs/realtime-sport-updates

Template for a match started notification.

```text
Match started
{{ payload.event.home_team }} - {{ payload.event.away_team }}
```

--------------------------------

### Initialize SDK Integration

Source: https://docs.xtremepush.com/docs/react-native

Execute the automated setup to modify native files and inject initialization code.

```bash
npx xtremepush-setup init
```

--------------------------------

### Attributes condition example

Source: https://docs.xtremepush.com/apidocs/segment-modal-properties

Example structure for defining attribute-based conditions.

```json
[
    "tags_attributes",
    "=",
    "TAG_ID or TAG_TITLE",
    ["value", "> / < / = / !=", "some value"]
]
```

--------------------------------

### Flags condition example

Source: https://docs.xtremepush.com/apidocs/segment-modal-properties

Example structure for defining flag-based conditions.

```json
[
    "tags_flag",
    "=",
    "TAG_ID or TAG_TITLE",
    ["status", "=", "on / off"]
]
```

--------------------------------

### Generate Configuration File

Source: https://docs.xtremepush.com/docs/react-native

Create the configuration template in the project root.

```bash
npx xtremepush-setup generate-config
```

--------------------------------

### Period Start Campaign Content

Source: https://docs.xtremepush.com/docs/realtime-sport-updates

Template for a second half start notification.

```text
Second half started
{{ payload.event.home_team }} - {{ payload.event.away_team }}
```

--------------------------------

### Verify SDK Integration

Source: https://docs.xtremepush.com/docs/react-native

Run the verification command to check the current project setup and identify potential configuration issues.

```bash
npx xtremepush-setup verify --verbose
```

--------------------------------

### Full Application Delegate Integration

Source: https://docs.xtremepush.com/docs/ios-inbox

Complete implementation example for initializing the SDK and enabling the inbox in the application delegate.

```Objective-C
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// ... 
[XPush setInboxEnabled:YES]; 
// ... 
[XPush applicationDidFinishLaunchingWithOptions:launchOptions]; return YES; }
```

```Swift
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
        // Override point for customization after application launch.
        //Start - Initialise XPush
        //...
        XPush.setInboxEnabled(true)
        XPush.registerForRemoteNotificationTypes(NotificationSettings.getNotificationSettings())
        XPush.applicationDidFinishLaunchingWithOptions(launchOptions)
        //End - Initialise XPush
```

--------------------------------

### Install iOS Dependencies

Source: https://docs.xtremepush.com/docs/react-native

Installs required CocoaPods dependencies for the iOS project.

```bash
cd ios && pod install && cd ..
```

--------------------------------

### Create helper-frame.html

Source: https://docs.xtremepush.com/docs/web-sdk-for-amp-pages

This file initializes the Xtremepush SDK. Replace 'path/to/sdk.js' with the actual path provided in your Xtremepush platform integration settings.

```html
<!doctype html>
<html>
<!-- AMP Web Push Helper IFrame -->

<head>
 <meta charset="utf-8">

 <script type="text/javascript">
 	 (function(p,u,s,h,e,r,l,i,b) {p['XtremePushObject']=s;p[s]=function(){
 	 	 (p[s].q=p[s].q||[]).push(arguments)};i=u.createElement('script');i.async=1;
 	 	 i.src=h;b=u.getElementsByTagName('script')[0];b.parentNode.insertBefore(i,b);
 	 })(window,document,'xtremepush','path/to/sdk.js');
 </script>

</head>
<body>
</body>
</html>
```

--------------------------------

### Configure Rich Media Notifications

Source: https://docs.xtremepush.com/docs/react-native

Enable rich media support in the configuration file and run the setup command.

```javascript
module.exports = {
  enableRichMedia: true,
  devTeam: 'YOUR_APPLE_TEAM_ID',
};
```

```terminal
npx xtremepush-setup ios
```

--------------------------------

### Break Start Campaign Content

Source: https://docs.xtremepush.com/docs/realtime-sport-updates

Template for a break start notification including current scores.

```text
Half time
{{ payload.event.home_team }} ({{ payload.event.home_score }}) - ({{ payload.event.away_score }}) {{ payload.event.away_team }}
```

--------------------------------

### Enable Debug Mode

Source: https://docs.xtremepush.com/docs/react-native

Run the initialization command with the DEBUG environment variable set to 1 to output verbose logs during setup.

```bash
DEBUG=1 npx xtremepush-setup init
```

--------------------------------

### Initialize the SDK in AppDelegate

Source: https://docs.xtremepush.com/docs/ios-sdk-integration

Configure the SDK within the application delegate's launch method using your application key.

```Swift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {    
    XPush.setAppKey("XPUSH_APP_KEY")
    #if DEBUG
    // Show Debug logs in debug builds
    XPush.setShouldShowDebugLogs(true)
    #endif
    XPush.applicationDidFinishLaunching(options: launchOptions)    
    return true
}
```

```Objective-C
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [XPush setAppKey: @"XPUSH_APP_KEY"];
    #if DEBUG
    // Show Debug logs in debug builds
    [XPush setShouldShowDebugLogs:YES]; 
    #endif 
    [XPush applicationDidFinishLaunchingWithOptions:launchOptions];
}
```

--------------------------------

### Initialize SDK with Geofence and iBeacon Monitoring

Source: https://docs.xtremepush.com/docs/android-sdk-location

Enable geofence and iBeacon monitoring individually during SDK initialization.

```java
mPushConnector = new PushConnector.Builder("XPUSH_APP_KEY", "GOOGLE_SENDER_ID")
    .setEnableGeo(true)
    .setEnableBeacons(true)
    .create(this);
```

--------------------------------

### Update segment response examples

Source: https://docs.xtremepush.com/apidocs/update-segment

Examples of JSON responses for successful and error scenarios when updating a segment.

```json
{
  "success": "True",
  "code": "200",
  "message": "Segment is successfully updated",
  "model": {
    "id": "SEGMENT_ID",
    "project_id": "PROJECT_ID",
    "title": "Email subscribed",
    "conditions": {
      "0": {
        "0": [
          "email_subscription",
          "=",
          "0"
        ],
        "operator": "AND"
      },
      "operator": "AND"
    }
  }
}
```

```json
{
  "success": "False",
  "code": "400",
  "message": "General error information"
}
```

```json
{
  "success": "False",
  "code": "404",
  "message": "Not Found"
}
```

--------------------------------

### Check SDK Initialization Manually

Source: https://docs.xtremepush.com/docs/react-native

Use grep to search for XtremePush references in Android and iOS source files to confirm the SDK is correctly initialized.

```bash
# Android - Check SDK initialization
grep -r "XtremePush" android/app/src/main/java/

# iOS - Check SDK initialization
grep -r "XtremePush" ios/*/AppDelegate.*
```

--------------------------------

### Configure Android Manifest for Install Referrer

Source: https://docs.xtremepush.com/docs/kochava

Register the ReferrerReceiver in your Android Manifest to handle install attribution.

```xml
<receiver android:name="ie.imobile.extremepush.receivers.ReferrerReceiver"> 
<intentfilter>
  <action android:name="com.android.vending.INSTALL_REFERRER" />
  <category android:name="YOUR_PACKAGE_NAME" /> 
</intentfilter>
</receiver>
```

--------------------------------

### Create Filters, Metrics, and Custom Columns

Source: https://docs.xtremepush.com/docs/custom-expressions

Examples of expressions used to filter rows, calculate percentages, and derive new column values.

```text
= contains([comment], "Xtremepush")
```

```text
= share([Bet Amount] > 50)
```

```text
= [Stake Amount] - [Win Amount]
```

--------------------------------

### Redeem Transaction Payload Example

Source: https://docs.xtremepush.com/docs/monitor-user-transactions

Example JSON payload sent to an external integration when a user redeems a reward.

```json
{
 	"event": "redeem.static",
 	"redeemOptionName": "5c787af5-d28e-4567-809c-b030877d9355",
 	"namespace": "1",
 	"transactionId": "eefa3829-2d0c-4785-ab52-5e10e7eb404e",
 	"userId": "User 123",
 	"price": 200,
 	"productName": "Free Tickets",
 	"address": "address_123",
 	"email": "[email protected]"
}
```

--------------------------------

### POST /create

Source: https://docs.xtremepush.com/apidocs/create

Creates a new campaign in the system.

```APIDOC
## POST /create

### Description
Creates a new campaign with specified settings and channels.

### Method
POST

### Endpoint
/create

### Parameters
#### Request Body
- **apptoken** (string) - Required - Your App token
- **title** (string) - Required - The title of your campaign
- **trigger** (integer) - Optional - The type of campaign to create (0: Scheduled, 1: Geo/iBeacon, 2: Event, 3: Api)
- **category_id** (integer) - Optional - The ID of the engagement category
- **target_applications** (integer) - Optional - The ID or IDs of the app or site to target
- **email** (boolean) - Optional - Enable email message channel
- **sms** (boolean) - Optional - Enable sms message channel
- **android_push** (boolean) - Optional - Enable push message channel on Android
- **ios_push** (boolean) - Optional - Enable push message channel on iOS
- **ios_push_production** (boolean) - Optional - Enable push message channel for iOS production builds
- **ios_push_sandbox** (boolean) - Optional - Enable push message channel for iOS dev builds
- **web_push** (boolean) - Optional - Enable web push message channel
- **web_push_chrome** (boolean) - Optional - Enable web push messaging for Chrome and Opera
- **web_push_firefox** (boolean) - Optional - Enable web push messaging for Firefox
- **web_push_safari** (boolean) - Optional - Enable web push messaging for Safari
- **inbox** (boolean) - Optional - Enable inbox message channel
- **webhook** (string) - Optional - Enable webhook message channel
- **encryption** (integer) - Optional - Encryption setting (0: Off, 1: Use where possible, 2: Enforce)

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the operation was successful
- **code** (integer) - Status code
- **message** (string) - Success message
- **model** (object) - The created campaign object

#### Error Response (400)
- **success** (boolean) - Indicates failure
- **code** (integer) - Status code
- **message** (string) - Error message
```

--------------------------------

### Open Full-Screen Loyalty View

Source: https://docs.xtremepush.com/docs/load-the-widget

Launches the loyalty interface as a full-screen view, supporting default, path-specific, and parameterized configurations.

```Java
// Open default view
mPushConnector.openLoyalty(activity);

// Open a specific path
mPushConnector.openLoyalty(activity, "THE_PATH");

// Open a specific path with custom parameters
JSONObject params = new JSONObject();
params.put("color-mode", "dark");
params.put("lang", "es");
mPushConnector.openLoyalty(activity, "THE_PATH", params);
```

```Objective-C
// Open default view
[XPush openLoyalty];

// Open a specific path
[XPush openLoyaltyWithPath:@"THE_PATH" params:nil];

// Open a specific path with custom parameters
NSDictionary *params = @{
 	@"color-mode": @"dark",
 	@"lang": @"es"
};
[XPush openLoyaltyWithPath:@"THE_PATH" params:params];
```

```Swift
// Open default view
XPush.openLoyalty()

// Open a specific path
XPush.openLoyalty(withPath: "THE_PATH", params: nil)

// Open a specific path with custom parameters
let params = [
 	"color-mode": "dark",
 	"lang": "es"
]
XPush.openLoyalty(withPath: "THE_PATH", params: params)
```

--------------------------------

### Tags condition example

Source: https://docs.xtremepush.com/apidocs/segment-modal-properties

Example structure for defining tag-based conditions with optional hit counts and date modifiers.

```json
[
    "tags", 
    "=",
    "TAG_ID or TAG_TITLE",
    ["hits", "> / < / =", "number of hits"]
    daterange or days ago (optional) (see examples below)
]
```

--------------------------------

### Generate Keys with Java Keytool

Source: https://docs.xtremepush.com/docs/oauth20

Create a Java KeyStore and convert it to PKCS12 format for use in Java-based environments.

```bash
# This command will ask for additional information. In the last step type `yes` and press Enter
keytool -genkey -alias <UNIQUE_KEY_IDENTIFIER> -keyalg RSA -keysize 2048 -validity <MAX_CERT_AGE> -keystore xtremepush.jks
# Import keys from the KeyStore
keytool -importkeystore -srckeystore xtremepush.jks -destkeystore xtremepush.p12 -deststoretype PKCS12
```

--------------------------------

### Complete Foreground Notification Implementation

Source: https://docs.xtremepush.com/docs/mobile-foreground-notifications-handling

A full example combining foreground notification registration and custom message response handling.

```Swift
// Show OS notifications in foreground
XPush.registerForegroundNotificationOptions { (message :XPMessageResponse) in
    return [.alert, .sound, .badge]
}
// Register custom message handler
XPush.registerMessageResponseHandler { (response: XPMessageResponse) in
        if response.action.type == .present {
            // Show an article dialog with "View" button
            self.showArticleDialog(response.message, clickCallback: {
               XPush.clickMessage(response.message)
            })
        }
}
```

```Objective-C
// Show OS notifications in foreground
[XPush registerForegroundNotificationOptions: ^XPNotificationType(XPMessageResponse *response) {
        return XPNotificationType_Alert | XPNotificationType_Sound | XPNotificationType_Badge;
}];
// Register custom message handler
[XPush registerMessageResponseHandler: ^(XPMessageResponse * _Nonnull response) {        
        if (response.action.type == XPActionType_Present) {
            // Show an article dialog with "View" button
            [self showArticleDialog: response.message viewButtonCallback: ^{
                // Process message click
                [XPush clickMessage:response.message actionIdentifier:nil];
            }];
        }
    }];
```

--------------------------------

### OTP History List Response Examples

Source: https://docs.xtremepush.com/apidocs/otp-history-list

Examples of successful and error responses from the OTP History List API.

```json
{
  "success": "True",
  "code": "200",
  "data": [
    {
      "otp_id": "01940221-566f-71ad-9702-39b8c8718cab",
      "integration_id": "9",
      "profile_id": "11e93ff698f70bb681ec0a22275e6966",
      "mobile_number": "+380987050091",
      "request_ts": "2024-12-26T08:42:06Z",
      "verified_ts": "2024-12-26T08:43:25Z",
      "source": "1"
    }
  ]
}
```

```json
{
  "success": "False",
  "code": "400",
  "message": "Invalid request",
  "errors": [
    {
      "text": [
        "Missing or invalid 'apptoken'"
      ]
    }
  ]
}
```

--------------------------------

### Verify SDK Integration

Source: https://docs.xtremepush.com/docs/react-native

Use the CLI tool to verify the SDK integration status.

```bash
npx xtremepush-setup verify
```

```bash
npx xtremepush-setup verify --verbose
```

--------------------------------

### PushConnector.Builder Configuration

Source: https://docs.xtremepush.com/docs/android-sdk-location

Methods used to initialize location, geofence, and beacon monitoring during SDK setup.

```APIDOC
## PushConnector.Builder Configuration

### Description
Configures location-based features including geofencing and iBeacon monitoring during the initialization of the Xtremepush SDK.

### Methods
- `setEnableLocations(boolean)`: Enables or disables general location services.
- `setEnableGeo(boolean)`: Enables or disables geofence monitoring.
- `setEnableBeacons(boolean)`: Enables or disables iBeacon monitoring.
- `setLocationUpdateTimeout(int)`: Sets the interval in seconds for additional GPS checks.
- `setLowPowerGeo(boolean)`: Disables additional location checks to save battery.

### Example
```java
mPushConnector = new PushConnector.Builder("XPUSH_APP_KEY", "GOOGLE_SENDER_ID")
    .setEnableLocations(true)
    .setLocationUpdateTimeout(10)
    .create(this);
```
```

--------------------------------

### Install Plugin without Location Services

Source: https://docs.xtremepush.com/docs/phonegap

Use this command to install the plugin while excluding geo-location and beacon frameworks.

```bash
cordova plugin add  https://github.com/xtremepush/XtremePush-Phonegap#master-geo-beacon
```

--------------------------------

### Events topic payload example

Source: https://docs.xtremepush.com/docs/topic-formats-payload-requirements

A concrete example of a bet event payload including user attributes and event-specific values.

```json
{
  "event": "bet",
  "user_id": "3e685367-07d5-4d48-93ae-f007ac336605",
  "customer_id": 12345,
  "user_attributes": {
    "customer_tier": "VIP"
  },
  "value": {
    "bet_id": "3e685367-07d5-4d48-93ae-f007ac336605",
    "odds": 12.2,
    "stake": 100.0
  },
  "timestamp": "2024-09-01 12:00:00.123"
}
```

--------------------------------

### Error API Response Example

Source: https://docs.xtremepush.com/docs/external-api-overview

Example of a 400 Bad Request response, including specific field validation errors.

```json
{
  "code": 400,
  "success": false,
  "message": "Campaign is not created",
  "errors": {
    "text": ["Text cannot be blank."]
  }
}
```

--------------------------------

### Custom Notification Handling Example

Source: https://docs.xtremepush.com/docs/mobile-message-custom-handling

A comprehensive implementation showing how to handle message presentation and specific user click actions.

```java
@Override
 		public void messageResponseReceived(final Message messagePayload,
 				HashMap<String, String> responsePayload,
 				final WeakReference uiReference) {

 		switch (responsePayload.get("type")) {

 			// When app is received in the foreground show a custom notification
 			case "present":
 				if (uiReference != null && uiReference.get() != null) {
 					((Activity) uiReference.get()).runOnUiThread(new Runnable() {
 						@Override
 						public void run() {
 							AlertDialog.Builder builder = new AlertDialog.Builder((Activity) uiReference.get());
 							builder.setPositiveButton("View", new DialogInterface.OnClickListener() {
 								public void onClick(DialogInterface dialog, int id) {
 									//go to article id
 									openArticle(messagePayload.data.get("articleId"));
 								}
 							});
 							builder.setMessage(messagePayload.text);
 							builder.setTitle(messagePayload.title);
 							AlertDialog dialog = builder.create();
 							dialog.show();
 						}
 					});
 				}
 				break;

 			//when message is clicked
 			case "click":
 				//default click action
 				if (!(responsePayload.containsKey("action"))) {
 					//navigate to article
 					openArticle(messagePayload.data.get("articleId"));
 				}
 				//action for a certain button click
 				else {
 					switch (responsePayload.get("action")) {
 						case "like":
 							//like article
 							likeArticle(messagePayload.data.get("articleId"));
 							break;
 					}
 				}
 				break;
 		}
 	}
```

--------------------------------

### Successful API Response Example

Source: https://docs.xtremepush.com/docs/external-api-overview

Example of a 200 OK response containing a success message and the associated model data.

```json
{
  "code": 200,
  "success": true,
  "message": "Campaign successfully created",
  "model": {
    "id": CAMPAIGN_ID,
    "text": "Testing Campaign is sent to subscribers to 15_01_04",
    "title": "Flag Test Campaign",
    ....
  }
}
```

--------------------------------

### Initialize with Public Key Pinning

Source: https://docs.xtremepush.com/docs/android-sdk-integration

Include the public key in the PushConnector builder for enhanced security.

```Java
new PushConnector.Builder(XPUSH_APP_KEY, GOOGLE_PROJECT_NUMBER)
        ...
        .setServerExpectedPublicKey(<THE PUBLIC KEY>)
        .create(this);
```

--------------------------------

### OTP History List Request Examples

Source: https://docs.xtremepush.com/apidocs/otp-history-list

Examples of JSON request bodies for ordering and filtering OTP history records.

```json
{
  "apptoken": "YOUR_APPTOKEN",
  "order": [
    "profile_id"
  ]
}
```

```json
{
  "apptoken": "YOUR_APPTOKEN",
  "condition": [
    [
      "profile_id",
      "=",
      "profileId"
    ]
  ]
}
```

```json
{
  "apptoken": "YOUR_APPTOKEN",
  "order": [
    "request_ts DESC"
  ]
}
```
Tokens:
Raw