Use the Splunk MINT REST API

Use a RESTful API with Splunk MINT to retrieve insights, upload dSYMs, and manage projects and teams. This interface incorporates several elements of the REST tradition, making access to these actions consistent and intuitive. All responses are in JSON format.

The examples in this topic show the supported API commands using curl. Curl is a command-line utility for performing HTTP requests and is available on most Unix systems, but you can use any tool or language that can submit HTTP requests.

Get insights

Use the following REST command to get insights about your mobile app usage.

curl --header "X-Splunk-Mint-Auth-Token: YOUR_API_TOKEN" \
    https://mint.splunk.com/api/v1/project/YOUR_API_KEY/analytics.json

Response

{
   "unique_affected_users": [3, 0, 4, 3, 2, 1, 0],
   "crashes": [3, 0, 4, 3, 2, 1, 0],
   "sessions": [986, 987, 1069, 1368, 1421, 1288, 401],
   "days": 7,
   "unique_users": [564, 535, 588, 769, 765, 653, 234],
   "overquotas": false
}

To get other insights, replace analytics.json in the URL with one of the following:

• analytics/devices.json

• analytics/versions.json?category=app_versions

• analytics/versions.json?category=app_versions

• analytics/versions.json?category=os_versions

• analytics/top_errors.json

• analytics/trending_errors.json

Upload dSYM files

To upload a dSYM file, you can use the sample Python BugSense API client or the curl command.

To find your API access token, on your Splunk MINT Management Console dashboard go to Account>Account Info.

python bugsense_cli.py YOUR_API_KEY YOUR_API_TOKEN \
    -dsym ../dsyms/crash-me3.app.dSYM

or

curl -F file=@"/path/to/dsym.zip" \
    --header "X-Splunk-Mint-apikey: YOUR_API_KEY \
    --header "X-Splunk-Mint-Auth-Token: YOUR_API_TOKEN" \
    https://ios.splkmobile.com/api/v1/dsyms/upload -i

Upload ProGuard mapping files

To upload a ProGuard mapping file, you can use the sample Python BugSense API client or the curl command.

To find your API access token, on your Splunk MINT Management Console dashboard go to Account>Account Info.

python bugsense_cli.py YOUR_API_KEY YOUR_API_TOKEN \
    -mappings mappings1.4.txt -app_version 1.4

or

curl -F file=@"/path/to/mapping.txt" \
    --header "X-Splunk-Mint-apikey: YOUR_API_KEY" \
    --header "X-Splunk-Mint-Auth-Token: YOUR_API_TOKEN" \
    --header "X-Splunk-Mint-appver: YOUR_APP_VERSION" \
    https://symbolicator.splkmobile.com/upload/mapping -i

Get project errors

This API has been deprecated and is not supported at this time.

curl --header "X-Splunk-Mint-Auth-Token: YOUR_API_TOKEN" \
    https://mint.splunk.com/api/v1/project/YOUR_API_KEY/errors.json