API via curl
You can use curl via the unix command line to submit API requests.
PREREQUISITES:
- For standard API token: Obtain a token via a get token call since all API calls require a token
- For personal API Token introduced in v7.1.0: Generate New Personal API Token
Accessing API via curl
Standard API Token
Here are some test examples for fetching (GET) data and inserting (POST) data using the standard API token (obtained via get_token call):
Fetch data
curl -X GET "https://yourserver.metricinsights.com/api/user_group" -H "Accept:application/json" -H "Content-Type:application/json" -H "Token:CaA3cEEkNp8R5k9t1QNHkMxdGRjigzrtYPnLWWZTwyvazbFEtu"
Insert data
curl -H "Accept:application/json" -H "Content-Type:application/json" -H "Token:CaA3cEEkNp8R5k9t1QNHkMxdGRjigzrtYPnLWWZTwyvazbFEtu" -d '{"name":"group 123","description":"created via API","all_access_group":"No"}' "https://yourserver.metricinsights.com/api/user_group"
Personal API Token
Below are examples of API calls using the personal API Token (v7.1.0+):
Fetch data
curl -X GET "https://yourserver.metricinsights.com/api/user_group" -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization: Bearer MjgwMzIyNTE1MzpXAmQqmklSaJyCrcEGE3xzkT9pLIe4gnBrIwVE66okfaIJ4qn4mjkHbmNQj6dOMxoNMueH3EsHZtijkvrItAi3R+xFyoMpvjQpX4BvZVdKkne7VCJa"
Insert data
curl -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization: Bearer MjgwMzIyNTE1MzpXAmQqmklSaJyCrcEGE3xzkT9pLIe4gnBrIwVE66okfaIJ4qn4mjkHbmNQj6dOMxoNMueH3EsHZtijkvrItAi3R+xFyoMpvjQpX4BvZVdKkne7VCJa" -d '{"name":"group 123","description":"created via API","all_access_group":"No"}' "https://yourserver.metricinsights.com/api/user_group"