Skip to main content

Making Your First Call

How to make your first call with Auxia

Step 1: Create a sample treatment

Visit the guide here (Creating your first treatment) to set up a sample treatment for testing.

Step 2: Fire request

Go to the console, click on the API Integration tab, and click "Show API Key" to get the API Key.

api-integration

Once you have the API key, fire the curl request below through the UI or from your terminal.

curl --location --request POST 'https://apis.auxia.io/v1/GetTreatments' \
--header 'Content-Type: application/json' \
--header 'x-api-key: *********************' \
--data-raw '{
"projectId": "1802",
"userId": "gGTE8CWUIgpzPivCejVk7JN284V",
"surfaces": [
{
"surface": "HOME_PAGE",
"maximumTreatmentCount": 1
}
]
}'

Understanding The Request

{
"projectId": "1802",
"userId": "gGTE8CWUIgpzPivCejVk7JN284V",
"surfaces": [
{
"surface": "HOME_PAGE",
"maximumTreatmentCount": 1
}
]
}

This request has the following parameters:

ParamTypeDescription
projectIdstringFor a given customer's project, this should always be the same.
userIdstringThis is the Unique ID for every user.
surfacesstringRefer to the surface json

Surface

ParamTypeDescription
surfacestringClient configured parameter to request treatments for a particular UI component, screen (home screen), or use case (coupon). A typical example of surface is "HOME_SCREEN" or "PURCHASE_SCREEN".
maximumTreatmentCountint64Maximum number of treatments that should be returned to the client for the given surface. If no value is set, this defaults to 1.
minimumTreatmentCountint64Minimum number of treatments that should be returned to the client for a given surface. If this field is set, the response is guaranteed to have either 0 or greater than equal to the value of minimumTreatmentCount number of treatments. If no value is set, it defaults to 0.

See below for a sample response:

{
"responseId": "690e24d8-16a6-4518-bf37-09a8f0120dfb",
"userTreatments": [
{
"treatmentId": "6",
"treatmentTrackingId": "6_690e24d8-16a6-4518-bf37-09a8f0120dfb",
"rank": "1",
"treatmentContent": "{ title: 'You have a new message!', description: 'Learn how our product helps you', cta_name: 'Learn more', cta_link: '/tabs/home/feed'}",
"treatmentType": "IN_APP_CONTENT_CARD",
"surface": "HOME_PAGE",
"contentLanguageCode": "en",
},
{
"treatmentId": "4",
"treatmentTrackingId": "4_690e24d8-16a6-4518-bf37-09a8f0120dfb",
"rank": "2",
"treatmentContent": "{ title: 'Check out your trends', description: '87% of users found this feature useful', cta_name: 'View trends', cta_link: '/actionscreen'}",
"treatmentType": "IN_APP_CONTENT_CARD",
"surface": "HOME_PAGE",
"contentLanguageCode": "en",
}
]
}