authenticate
A Graze API GET request that provides the auth_token required by all other Graze API requests which do not provide the basic authentication header. Graze users can have multiple concurrent Graze sessions with the same username and password.
All requests (other than authenticate) require a valid auth_token or basic authentication header. Therefore before any Graze API request is used, a valid authenticate request must be successfully made unless basic authentication headers are used.
Inactive sessions will be logged out after one hour, and a new authenticate request must be made to get a new valid auth_token.
If you make regular Graze requests within a one hour timeframe, you are considered active and your session does not expire. Inactive sessions are logged out after one hour, and you must make a new authenticate request to get a new valid auth_token.
Back to Graze API EndPoint Reference.
Request arguments
Endpoint authenticate takes the following request arguments:
Name | Type | Required | Description |
|---|---|---|---|
| String | Yes | A valid Moogsoft Enterprise username. |
| String | Yes | The username's corresponding password. |
Response
Endpoint authenticate returns the following response:
Successful requests return a JSON object containing the following:
Name | Type | Description |
|---|---|---|
| String | A session ID for use in subsequent requests. |
Examples
The following examples demonstrate typical use of endpoint authenticate:
Request examples
Example cURL request to return an authorization token for username "JohnJones" and password "password":
curl -k -v "https://localhost/graze/v1/authenticate?username=JohnJones&password=password"
Example cURL request to return an authorization token for the Graze user:
curl -k -v "https://localhost/graze/v1/authenticate?username=graze&password=graze"
Response example
Example response returning the authorization token:
{"auth_token":"878b3ec57d464aee80d09893221be8e8"}auth_token examples
Example of authentication using an auth_token:
"https://localhost/graze/v1/resolveSituation?auth_token=878b3ec57d464aee80d09893221be8e8&sitn_id=10" --insecure -X POST -v
JSON authentication example using an auth_token:
https://localhost/graze/v1/resolveSituation" -H "Content-Type: application/json; charset=UTF-8" --insecure -X POST -v --data '{"auth_token" : "878b3ec57d464aee80d09893221be8e8","sitn_id" : 10}'