API Authentication

Prior to issuing any API call, you will first need to authenticate with the VALT application. This should be completed by issuing the following API call. After authenticating successfully, you will receive an access token. Save this access token as it will be used in all other API calls.

Resource URL

http://valt.example.com/api/v3/login

Resource Information

Method	POST
Headers	Content-Type:application/json
Response Type	JSON
Authentication Required	No

Parameters

Name	Description	Required	Example
Username	Username for a VALT user, can be a local or LDAP user.	yes	admin
Password	VALT password for the specified user.	yes	admin

Response

Code	Reason
200	Authentication Successful
401	Invalid Username or Password

JSON Response

data
access_token	access token for use in any API calls that require authentication

Examples

Request

The sample JSON body below is formatted with line breaks and indentation to make it easier to read. This is not required.

https://ivstest1.ad.ipivs.com/api/v3/login

{
  "username":"admin",
  "password":"admin"
}

Successful Response

{"data":{"access_token": "e82632d19c523678fea3d1016c6df9e9" }}

Failure Response

{"data": "Invalid username or password"}