Overview

This web service allows user to retrieve a session ticket for subsequent web service requests after receiving valid account information such as account code, user name and password.

Request Format

PwsAuthenticateRq

PwsAuthenticateRq
- RequestId: Int32
- SessionTicket: String
- AccountCode: String
- CultureName: String
- Fingerprint: String
- Password: String
- UserName: String
- UtcOffsetMinutes: Int16
- CrossoverTicket: String

Request Elements

Element	Data Type	Description
Messages	PwsMessage[]
ResponseId	Int32	Click here for more information.
Status	RequestStatus	Click here for more information.
ServerTimestampUtc	DateTime	Click here for more information.
RedirectUrl	String
SessionTicket	String	Click here for more information.
AccountIdentity	PwsAccountRef
UserIdentity	PwsUserRef
SuperUserFlag	Boolean
DocumentServerUrl	String
Account	PwsAccountSummary
User	PwsUserSummary

Request Usage Example(s)

Request 01

      <pws:PwsAuthenticate>
         <pws:serviceRequest>
            <req:Password>1JiLei$</req:Password>
            <req:UserName>larry@revcorp.min</req:UserName>
         </pws:serviceRequest>
      </pws:PwsAuthenticate>

Response Format

PwsAuthenticateRs

PwsAuthenticateRs
- Messages: PwsMessage[]
- ResponseId: Int32
- Status: RequestStatus
- ServerTimestampUtc: DateTime
- RedirectUrl: String
- SessionTicket: String
- AccountIdentity: PwsAccountRef
- UserIdentity: PwsUserRef
- SuperUserFlag: Boolean
- DocumentServerUrl: String
- Account: PwsAccountSummary
- User: PwsUserSummary

Response Elements

Element	Data Type	Description
Messages	PwsMessage[]
ResponseId	Int32	Click here for more information.
Status	RequestStatus	Click here for more information.
ServerTimestampUtc	DateTime	Click here for more information.
RedirectUrl	String
SessionTicket	String	Click here for more information.
AccountIdentity	PwsAccountRef
UserIdentity	PwsUserRef
SuperUserFlag	Boolean
DocumentServerUrl	String
Account	PwsAccountSummary
User	PwsUserSummary

Response Usage Example(s)

Response 01

     <PwsAuthenticateResponse>
         <PwsAuthenticateResult>
            <Messages i:nil="true"/>
            <ResponseId>0</ResponseId>
            <Status>Ok</Status>
            <ServerTimestampUtc>2018-01-16T18:43:11.6585593Z</ServerTimestampUtc>
            <a:RedirectUrl i:nil="true"/>
            <a:SessionTicket>ARQC8d/V3CZk+kOWf7w3KQ==</a:SessionTicket>
            <a:AccountIdentity>
               <b:AccountCode>revcorp-min</b:AccountCode>
               <b:AccountId i:nil="true"/>
               <b:AccountUid>1152921504606848622</b:AccountUid>
            </a:AccountIdentity>
            <a:UserIdentity>
               <b:UserDisplayName>Krakauer, Larry</b:UserDisplayName>
               <b:UserId i:nil="true"/>
               <b:UserReferenceSystemId>097</b:UserReferenceSystemId>
               <b:UserUid>1152921504606944254</b:UserUid>
            </a:UserIdentity>
            <a:SuperUserFlag>false</a:SuperUserFlag>
            <a:DocumentServerUrl>https://docqa.projectorpsa.com/1</a:DocumentServerUrl>
            <a:Account>
               <b:AccountCode>revcorp-min</b:AccountCode>
               <b:AccountId i:nil="true"/>
               <b:AccountUid>1152921504606848622</b:AccountUid>
               <b:Name>Revolutionary Solutions Corp (Min Zeng)</b:Name>
            </a:Account>
            <a:User>
               <b:UserDisplayName>Krakauer, Larry</b:UserDisplayName>
               <b:UserId i:nil="true"/>
               <b:UserReferenceSystemId>097</b:UserReferenceSystemId>
               <b:UserUid>1152921504606944254</b:UserUid>
               <b:EmailAddress>Larry@revcorp.min</b:EmailAddress>
               <b:FirstName>Larry</b:FirstName>
               <b:LastName>Krakauer</b:LastName>
               <b:MiddleName>Japan</b:MiddleName>
            </a:User>
         </PwsAuthenticateResult>
      </PwsAuthenticateResponse>

PwsAuthenticate - Common Errors and Warnings

For all errors and warnings please refer to the Complete List of Errors and Warnings

ErrorNumber	ErrorCode	ErrorText
10002	InvalidCredentials	The specified credentials are not valid. Please try again.
10111	RequiredFieldMissing	A required field is missing: UserName