POST api/hire/account

Request a token allowing use of the API

Request Information

URI Parameters

None.

Body Parameters

A AccountRequestModel

AccountRequestModel
NameDescriptionTypeAdditional information
username

The username you wish to log in as

string

None.

password

The password for the user you are attempting to log in as

string

None.

Request Formats

application/json, text/json

Sample:
{
  "username": "sample string 1",
  "password": "sample string 2"
}

application/xml, text/xml

Sample:
<AccountRequestModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <username>sample string 1</username>
  <password>sample string 2</password>
</AccountRequestModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

A LoginResponse

LoginResponse
NameDescriptionTypeAdditional information
UserID

The ID of the authenticated user

unsigned integer

None.

Authenticated

A flag to show if the user is authenticated or not

boolean

None.

BrandingID

An identifier for the branding that needs to be applied for this user

unsigned integer

None.

Name

A display name for the user

string

None.

AuthenticationToken

The authentication token for this user session

string

None.

Response Formats

application/json, text/json

Sample:
{
  "UserID": 1,
  "Authenticated": true,
  "BrandingID": 3,
  "Name": "sample string 4",
  "AuthenticationToken": "sample string 5"
}

application/xml, text/xml

Sample:
<LoginResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <UserID>1</UserID>
  <Authenticated>true</Authenticated>
  <BrandingID>3</BrandingID>
  <Name>sample string 4</Name>
  <AuthenticationToken>sample string 5</AuthenticationToken>
</LoginResponse>