Versions Compared

Old Version 29

changes.mady.by.user Valeriya Shishkova

Saved on

compared with

New Version Current

changes.mady.by.user Ruslan Tkachuk

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To execute S7 Agent API operations, applications must send an HTTPS POST request to the S7 Agent API endpoint.

Note

S7 Agent API doesn't support compressed request and/or response in GZIP format

Environments

Follow steps to quickly get an access to API

Excerpt


Actual



500.47
TestProduction
#VersionEndpointEndpoint
10.252WSDL

WSDL

30.45WSDLInactive40.35WSDLWSDL
Note

Prefer the latest version for new integration or upgrading from the old version

If you are ready for the new versions which are not installed on the production environment — notify our technical support by JIRA

Old

TestProduction
#VersionEndpointEndpoint
10.21WSDLDefaultWSDLDefault
Note

Avoid using old versions for integration — access to the production environment is provided only after a successful test with actual versions

2up torefund&deleteTST&schedule&split&postsalerefund&deleteTST&schedule
3up to

queue

queue

 


Table of contents:

Table of Contents

Schemas

S7 Agent API makes WSDLs for all of versions available for download.

When you are developing S7 Agent API applications that send requests and receive responses, you might find it helpful to validate the contents of your messages against the relevant schema. 

Headers

The following table describes the HTTP headers that you typically set in a S7 Agent API request:

#NameMandatoryKey in headersDescription
1Version of APIOptionalX-API-Version

Depends on version of API that you want to execute

(warning) If you didn't pass Version of API in request a default one will be executed

2Basic authorization stringRequiredAuthorizationCredentials that you received from our S7 technical support. Check out Quick Start for how to get it
3Operation nameRequiredSOAPActionDepends on operation that you want to execute
4Type of contentRequiredContent-TypeSets the content type of the request. Always "text/xml"

S7 agent API required encrypted HTTP requests via HTTPS only. Check out Quick Start for how to get SSL certificate.

The following example shows headers of a typical SearchFlights operation of 0.35 52 version API on Test environment:

Code Block
linenumberstrue
POST /agent-api/gaia HTTP/1.1
Host: qa-gaia.s7.ru
Content-Type: text/xml
SOAPAction: "http://api.s7.ru/SearchFlightsSearchFlightsJourney"
X-API-Version: 0.3552
Authorization: Basic oV5zbWlyCx92X3M3dfS6dGFpbDpxLTE2OXFs*********************

Versions

You can use any released versions if your requests conform that syntax. Check references for detailed explanation of input&output parameters and possible errors for every version of API.

If you didn't pass Version of API in request a default one will be executed. You always able to check executed API version in response headers.

But we recommend that you always specify version in all you request to avoid unexpected responses form another versions of API.

Operation names

Applications must send the "SOAPAction" key in headers of request to the S7 Agent API for determination of operation.

#OperationSOAPAction value (actual for v0.
35
52)
1
agentPayment
book"http://api.s7.ru/
AgentPayment
Book"
2
baggageCharges
cancelBooking"http://api.s7.ru/
BaggageCharges
CancelBooking"
3
book
changeBook
"http://api.s7.ru/
Book
ChangeBook"
4
cancelBooking
demandTickets"http://api.s7.ru/
CancelBooking
DemandTickets"
5
changeBook
flightInfo"http://api.s7.ru/
ChangeBook
FlightInfo"
6
demandTickets
orderCreate "http://api.s7.ru/
DemandTickets
OrderCreate"
7
findRules
orderChange"http://api.s7.ru/
FindRules
OrderChange"
8read"http://api.s7.ru/Read"
9reprice"http://api.s7.ru/Reprice"
10retrieveTicket"http://api.s7.ru/RetrieveTicket"
11
searchFlights
retrieve TST"http://api.s7.ru/
SearchFlights
RetrieveTST"
12searchFlightsFlex"http://api.s7.ru/SearchFlightsFlex"
13searchFlightsBySlice"http://api.s7.ru/SearchFlightsBySlice"
14searchFlightsJourney"http://api.s7.ru/SearchFlightsJourney"
15seatMap"http://api.s7.ru/SeatMap"
14
16servicePrice"http://api.s7.ru/ServicePrice"
15
17voidTicket"http://api.s7.ru/VoidTicket"
18schedule"http://api.s7.ru/agent/ndc/get-schedule"
19postsale"http://api.s7.ru/agent/ndc/add-postsell-ancillaries"

Common questions

Excerpt Include
Common | FAQ
Common | FAQ
nopaneltrue