Versions Compared

Key

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

This is a high-level overview of a typical response from S7 Agent API.

Headers

The following table describes the HTTP headers that you received in a S7 MSE API response:

#



Name

Key in headers

Description

1
Version of APIX-API-Version

Executed version of API

(warning) If you didn't pass Version of API in request you can find here an executed default version for current environment

Date and time

date

Date and time of request execution in GMT

2

Type of content

Content-Type

The content type of the response. Always "

text

application/xml"

3

Conversation ID

X

x-

API-Conversation

conversation

The identificatior of transaction.

(warning)

(warning) Pass it to our technical support by email at api.support@s7.ru if you faced problems with responses

The following example shows headers of a typical

SearchFlights operation

response of 0.

35

52 version API on Test environment:

Code Block
linenumberstrue
Date: Thu, 20 Jul 2023 13:18:39 GMT
Content-Type: 
text
application/xml
SOAPAction
Transfer-Encoding: 
"http://api.s7.ru/SearchFlights" X-API-Version: 0.35 Authorization: Basic oV5zbWlyCx92X3M3dfS6dGFpbDpxLTE2OXFs X-API-Conversation: ceec2d2d-8081-4d48-9df9-a712f6236220
chunked
Connection: keep-alive
X-Flow: 1ed1686b-cb2c-4f81-a5bd-fda6b5902042
X-Conversation: 58478262-ef5b-4e89-8c90-1d607917d413
vary: accept-encoding
Content-Encoding: gzip
Strict-Transport-Security: max-age=15724800; includeSubDomains


Table of contents:

Table of Contents

Successful results

Successful responses typically includes the following structurefollowing structure (actual for 0.35 52 version):

Expand


Code Block
languagexml
linenumberstrue
<?xml version="1.0" encoding="
utf
UTF-8" standalone="yes"?>
<result id="
vI6FGb59SpQWElktM09l44tkt
bd858aa6-e6e8-42b2-bd68-6b3416fc430a" session="
eFvNjn2PKFDJVAs0RLbhhZITz
0ff7767d-7505-48b5-9929-8992b627f898" solutionCount="
12
4" solutionSet="
FoS0VzPw4UkLQExJm46znbA
ed0d5377-0037-46eb-89f0-abbce67b9896">
    
<mso>
<solutions>
        <itinerary>
            <solution id="
pFo605MVUMf0VZaw2xYIZZVO0
0b124e58-d8cb-44f7-96e4-fdd406bf4bf7" saleTotal=
"RUB24050
"RUB9673" preferredFareFamily="CHEAPEST FARE">
                <ext link="https://
travelwith
ibe.s7.ru/mseDeeplink.action?LAN=RU&partner=
16f3d011b0
{{your_partner_id}}&TA=
2
1&TC=1&TI=
1
0&SUP=
SITA
XO&CP=F&CUR=RUB&TF=
24050
9673&FLC=1&FSC1=1&FN1=
179
1010&AC1=S7&DD1=
2017
2023-12-
06
15&DT1=
11
12:15:00&AD1=
2017
2023-12-
06
15&AT1=
19
13:
15
55:00&DA1=
DME
LED&AA1=
OVB
DME&SC1=
Q
N&utm_campaign={{your_utm_campaign}}&utm_campaign={{your_utm_source}}&utm_medium=metasearch&FF1=B">
                    <SalePriceWithoutYQ amount="
8600
5062" currency="RUB"/>
                    <SalePriceWithoutYQAndYR amount="
7100
5062" currency="RUB"/>
                    <SalePriceWithoutYR amount="
7100
5062" currency="RUB"/>
                </ext>
                <pricing paxCount="
2
1">
                    <ext>
                        <SalePriceWithoutYQ amount="
8600
5062" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="
7100
5062" currency="RUB"/>
                        <SalePriceWithoutYR amount="
7100
5062" currency="RUB"/>
                        <pax adults="
2
1"/>
                    </ext>
                </pricing>
                <pricing paxCount="1">
                    <ext>
                        <SalePriceWithoutYQ amount="
6850
4611" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="
5350
4611" currency="RUB"/>
                        <SalePriceWithoutYR amount="
5350
4611" currency="RUB"/>
                        <pax children="1"/>
                    </ext>
                </pricing>
            </solution>
            <slice>
                
<pricing paxCount="1
<segment arrival="2023-12-15T13:55+03:00" carrier="S7" departure="2023-12-15T12:15+03:00" destination="DME" duration="100" flight="S71010" origin="LED"/>
            </slice>
        </itinerary>
        <itinerary> >
        <itinerary> >
        <itinerary> >
        <itinerary>
            <solution id="0f4e91c7-897a-425e-bf40-dd14a3f10943" saleTotal="RUB9673" preferredFareFamily="CHEAPEST FARE">
               
<ext>
 <ext link="https://ibe.s7.ru/mseDeeplink.action?LAN=RU&partner={{your_partner_id}}&TA=1&TC=1&TI=0&SUP=XO&CP=F&CUR=RUB&TF=9673&FLC=1&FSC1=1&FN1=1016&AC1=S7&DD1=2023-12-15&DT1=20:35:00&AD1=2023-12-15&AT1=22:15:00&DA1=LED&AA1=DME&SC1=N&utm_campaign={{your_utm_campaign}}&utm_campaign={{your_utm_source}}&utm_medium=metasearch&FF1=B">
                    <SalePriceWithoutYQ amount="
0
5062" currency="RUB"/>
                    <SalePriceWithoutYQAndYR amount="
0
5062" currency="RUB"/>
                    <SalePriceWithoutYR amount="
0
5062" currency="RUB"/>
                </ext>
            
</pricing>
    <pricing paxCount="1">
                    <ext>
                        
<slice>
<SalePriceWithoutYQ amount="5062" currency="RUB"/>
                        
<segment
<SalePriceWithoutYQAndYR 
arrival
amount="
2017-12-06T19:15+07:00
5062" 
cabin
currency="
COACH" carrier="S7" departure="2017-12-06T11:15+03:00" destination="OVB" duration="240" flight="S7179" origin="DME"
RUB"/>
                        <SalePriceWithoutYR amount="5062" currency="RUB"/>
                        <pax adults="1"/>
                    </ext>
                </pricing>
                <pricing paxCount="1">
                    <ext>
                        <SalePriceWithoutYQ amount="4611" currency="RUB"/>
                    
<ext operationalDisclosure="OPERATED BY GLOBUS LLC
    <SalePriceWithoutYQAndYR amount="4611" currency="RUB"/>
                        <SalePriceWithoutYR amount="4611" currency="RUB"/>
                    
<operationalDisclosure carrier
    <pax children="
GH
1"/>
                    </
segment>
ext>
                </
slice>
pricing>
            </solution>
<solution> ... </solution>
            <slice>
                <segment arrival="2023-12-15T22:15+03:00" carrier="S7" departure="2023-12-15T20:35+03:00" destination="DME" duration="100" flight="S71016" origin="LED"/>
            </slice>
        </itinerary>
    </
mso>
solutions>
</result>


For more information about received data in successful response, check RQ pages divided by operation in reference reference.

Unsuccessful results

Unsuccessful responses typically includes the following structure following structure (actual for 0.35 52 version):

linenumbers
Expand


Code Block
languagexml
true
<?xml version=
'
"1.0
'
" encoding=
'
"UTF-8
'
" standalone="yes"?>
<result 
id
solutionCount="
C08FNvhbikL0RLcXhWhWcE
0">
    <error type="input">
        
<message>version: Unrecognized api version.<
<message>date.is.more.than.359.days.in.future</message>
    </error>
</result>


For an unsuccessful responses, API returns Errors with technical info in the message tag.

Сheck Errors page for more information about possible errors

Common questions

Excerpt Include
FAQ | S7 MSE API
FAQ | S7 MSE APInopaneltrue