POST Sessions
Create a new session for interaction with this API
The credentialed user must have Adminstrator privilege in Ascribe.
The response message contains two tokens, one of which must be passed in a header for all other operations with this API.
You may either use the bearerToken or the authenticationToken. Either send a header with key "authentication" and value the authenticationToken returned in this response,
or send a header with key "Authorization" and value the bearerToken returned in this response.
The bearerToken does not expire, but will become invalid if the user's credentials change.
The authenticationToken remains valid until no request is sent to this API using the authenticationToken for 30 minutes.
Request Information
URI Parameters
None.
Body Parameters
The credentials for the session.
NewSessionRequestName | Description | Type | Additional information |
---|---|---|---|
account |
The id of the Ascribe account. This is the id entered in the Account section of the logon page in Ascribe. |
string |
Required |
userName |
The logon name of the user. The created session will have this user associated with it. Any Inspections created during this session will have this user as the owner of the new Inspection. |
string |
Required |
password |
The user's password. |
string |
Required |
Response Information
Create a new session for interaction with this API
The credentialed user must have Adminstrator privilege in Ascribe.
The response message contains two tokens, one of which must be passed in a header for all other operations with this API.
You may either use the bearerToken or the authenticationToken. Either send a header with key "authentication" and value the authenticationToken returned in this response,
or send a header with key "Authorization" and value the bearerToken returned in this response.
The bearerToken does not expire, but will become invalid if the user's credentials change.
The authenticationToken remains valid until no request is sent to this API using the authenticationToken for 30 minutes.
Name | Description | Type | Additional information |
---|---|---|---|
authenticationToken |
This value must be sent in the authentication header of all interactions with the API. |
globally unique identifier |
Required |
bearerToken |
The bearer token must be sent in the Authorization header. |
string |
Required |
errors |
If null the request was processed without error. If not null errors occurred while processing the request. The array contains the error messages. |
Collection of string |
None. |