Page History

To execute a S7 Agent API operations,

you submit

applications must send an HTTPS

request

POST request to the

QPX

S7 Agent API endpoint.

For validating your requests that they conform to API's schemas use WSDLs.

Request

Applications must send an HTTPS POST request.

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

Headers

All requests to S7 Agent API must include the following:

#	Name	Key in headers	Value
1	Version of API

(the "

X-API-Version

" key in headers) – check Environment table for a value belowBasic authorization string (

depends on version of API that you want to execute

If you didn't pass Version of API in request it will execute the default one

2

Basic authorization string

Authorization

credentials

the "Authorization" key in headers) — credentials

that you received from our technical support.

Check

Check out Quick Start for how to get it
3	Operation name

(the "SOAPAction" key in headers) — check Operation table for a value below

	SOAPAction	depends on operation that you want to execute
4	Type of content

(the "

Content-Type

" key in headers) —

always "text/xml"

note

S7

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

S7 agent API required encrypted HTTP requests via HTTPS only. Check out Quick Start for how to get SSL certificate.For validating your requests that they conform to API's schemas use WSDLs. Links provided in Environment table.

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

Code Block

linenumbers	true

POST /agent-api/gaia HTTP/1.1
Host: qa-gaia.s7.ru
Content-Type: text/xml
SOAPAction: "http://api.s7.ru/SearchFlights"
X-API-Version: 0.35
Authorization: Basic oV5zbWlyCx92X3M3dfS6dGFpbDpxLTE2OXFs

Version of API

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 it will execute the default one will be executed. You always able to check executed API version in response headers.

one. 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.

#	Operation	SOAPAction value (actual for v0.35)
1	agentPayment	"http://api.s7.ru/AgentPayment"
2	baggageCharges	"http://api.s7.ru/BaggageCharges"
3	book	"http://api.s7.ru/Book"
4	cancelBooking	"http://api.s7.ru/CancelBooking"
5	changeBook	"http://api.s7.ru/ChangeBook"
6	demandTickets	"http://api.s7.ru/DemandTickets"
7	findRules	"http://api.s7.ru/FindRules"
8	read	"http://api.s7.ru/Read"
9	reprice	"http://api.s7.ru/Reprice"
10	retrieveTicket	"http://api.s7.ru/RetrieveTicket"
11	searchFlights	"http://api.s7.ru/SearchFlights"
12	seatMap	"http://api.s7.ru/SeatMap"
13	servicePrice	"http://api.s7.ru/ServicePrice"
14	voidTicket	"http://api.s7.ru/VoidTicket"

Response

Identifying requested version of API

Successful results

Unsuccessful results

Common questions

Excerpt Include

	Common \| FAQ
	Common \| FAQ
nopanel	true

Table of contents:

Table of Contents

Environment

Excerpt

		Test	Production
#	Version	Endpoint	Endpoint
1	0.21	WSDL	WSDL
2	0.35	WSDL

— default version for environment

— not installed on environment

Note
If you are ready to a new versions which are not installed on production environment — notify our technical support by JIRA

Note
Follow steps to quickly get an access to API

Page tree

Versions Compared

Old Version 4

New Version 5

Key