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	Required?	Description	Sample Data
RequestId	Int32	No	Click here for more information.
SessionTicket	String(24)	No	Click here for more information.
AccountCode	String(30)	Yes	The account code of the web service user's installation	revcorp-min
CultureName	String(15)	No	The culture name is a unique identifier for a culture	en-US
Fingerprint	String	No	Authentication that grants user special permissions; Leave blank unless otherwise instructed by Projector support.
Password	String(28)	Yes	The password of the web service user	1JiLei$
UserName	String(100)	Yes	The user name of the web service user	larry@revcorp.min
UtcOffsetMinutes	Int16	No
CrossoverTicket	String	No

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.