ASP.NET VETtrak API web services
ContentsIndexHome
PreviousUpNext
TAuthenticate Properties

The properties of the TAuthenticate class are listed here.

 
Name 
Description 
 
 
 
Represents the status as an enumeration, for internal use The status is exposed to the web service as an int 
 
Name 
Description 
 
ID 
ID of the User who generated the Token.
If an authentication is unsuccessful, the Identifier property is set to BAD_ID = '-1'. 
 
A Identifier of the User who generated the Token.
In the case of a Client, the Identifier is the Client's Clie_Code property. For an Employer, it is the Employer's Empl_Identifier property.
If an authentication is unsuccessful, the Identifier property is set to BAD_IDENTIFIER = '-1'. 
 
An Integer Status, which can take the following values:
  • STATUS_MISSING_REGISTRATION = -5: The registration key does not contain a valid entry required for the called function
  • STATUS_NO_RECORDS = -4: No records found. Often occurs because the requested record does not exist
  • STATUS_DB_ERROR = -3: Serious database error occurred
  • STATUS_EXPIRED = -2: Supplied token has expired. Tokens expire after 60 minutes of no use
  • STATUS_ERROR = -1: Error has occurred (such as invalid input)
  • STATUS_UNKNOWN = 0: Indeterminable problem has occurred
  • STATUS_OK = 1: Success
 
 
A Status Message, usually used when a problem occurs. 
 
A token which must be valid to access non public domain data from the database. An empty string ('') is usually returned as the Token if the is a problem executing a function which requires a Token.
A valid token contains information about the user who created it:
  • Identifier,
  • Token Type.

Both a Staff and Student user have type CLIE_TOKEN embedded in the token. This arises because they both come from the Client table. 
 
Type of Token.
This depends on who generated the Token. Valid Types are:
  • CLIE_TOKEN = '02' if generated by a Client (Student, Employee, ...),
  • STAF_TOKEN = '03' if generated by a Client who is a Staff Member.

Note a token only uses CLIE_TOKEN. However, some function may flag STAF_TOKEN for Clients who are Staff Members. 
Copyright (c) VETtrak 2022. All rights reserved.