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
MINT Documentation |
This documentation applies to the following versions of Splunk MINT™ REST API (Legacy): 4.0
Feedback submitted, thanks!