Documentation of the CarRentalAgentService

CarRentalAgentService. Method 

Retrieves a TicketGrantingTicket used to obtain a service Ticket.

public BrokerTicketGrantingTicketResponse (
   BrokerTicketGrantingTicketRequest request
);

Parameters

BrokerTicketGrantingTicketRequest
A TicketGrantingTicketRequest containing nessessary authentication data.

Return Value

A TicketGrantingTicketResponse containing the TicketGrantingTicket with token and secret.

Remarks

This is the first method you'll have to call from this service. It is the starting point in the authentication procedure.

In detail: Before you can use any other functionality of this service, you'll have to authenticate against the service. This is achieved by following the steps of the authentication procedure described in the CarRentalAgentService SDK - Reference Manual. This method is the first step of the authentication procedure.

In return, you'll get a TicketGrantingTicket, which will contain a token and a secret you need to complete the subsequent steps of the authentication procedure.

Note   

The returned TicketGrantingTicket will have a very short time of validity (usually 60 seconds). You must complete the complete authentication procedure within this time period. If you fail to complete the procedure in given time, the complete procedure will fail - even if the given data is valid. You then will have to start the authentication procedure again by calling this method.

List Of Errors Returned

Error Code Description
E_INTERNAL_SERVICE An internal service error occured during the process.
E_OPERATOR_KEY_INVALID The provided operator key is invalid.

This error occurs if:

  • The operator key is in invalid format.
  • The assosiated operator was not found using the operator key.
  • The associated operator contract is expired.
  • The operator has a weak passphrase for encryption.
E_REQUEST_INVALID The performed request is invalid or malformed.

Example

Obtaining a ticket granting ticket. 

[C#]
TicketGrantingRequest rq = new TicketGrantingRequest();
rq.OperatorKey = "000000";

TicketGrantingResponse rs = this.carAgent.GetTicketGrantingTicket(rq);

TicketGrantingTicket grant = rs.TicketGrantingTicket;

See Also

CarRentalAgentService Class | SunnyCars.Services.Osi.WsReservation Namespace