Versions Compared

Key

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

Steps

  1. Application

    Come to an agreement for connection
    All information required for connection — in one application

  2. Access to the test environment
    Get access to the test environment and integrate under the supervision of S7 technicians

  3. Running your tests

    Hello world!


    Set your software and make your first request!

  4. Running your tests
    Test the S7 MSE API to prevent future problems

  5. Access to production environment
    Get access to the production environment and complete integration

    .

  6. Maintenance
    Use the all of capabilities of the S7

    MSO

    MSE API and stay tuned for a new features!

Target period — 7 working days

Anchor
environment
environment

Environment

Test

Production

Endpoint: https://api.s7airlines.com/mse

Excerpt Include
Submitting requests | S7 MSE API
Submitting requests | S7 MSE API
nopaneltrue

Anchor
Step1
Step1
Step 1: Come to an agreement

Step 1: Application

for connection

  1. Contact to manager of your region and request for an application form at (Pavel Khomich (question))S7 MSE manager by mail at mse-s7tretail@s7.ru

  2. Enter into a service agreement with S7's Sales Department

  3. Our managers give you a sign, when you can start getting access to the test environment

Anchor
Step2
Step2
Step 2: Access to the test environment

  1. You must provide the ip addresses, subnet from which you will work with the test environment
  2. S7 technicals will add your ip addresses, subnet to the access list and sent notification about that

Step 3: Running your tests

  • Read MSO documentaion (link (warning))
  • Try send request and get succesfull response from the test environment
    1. Provide an IP address of a subnet, which you going to use for sending request to the test environment of S7 MSE API, to our technical support by mail at api.support@s7.ru

    2. S7 adds your subnet's IP address to the white access list on the test environment

    3. As soon as our technical support send to you an individual key for requests to the API by mail, you may proceed to tests

    Anchor
    Step3
    Step3
    Step 3: Hello world!

    1. For a better experience, we prefer to use Postman for testing:

    Panel

    Download the last binary version of Postman at https://www.postman.com/downloads/ and install software

    2. Open Postman and create a new REST project

    Panel
    1. Postman → New → HTTP

    2. Check available versions at test environment at the top of the page

    3. Copy relevant Endpoint

    3. Set method — POST

    4. Set headers in Header tab:

    Code Block
    Content-Type: text/xml
    X-API-Version: 0.52

    5. Fill in the request textarea by an example described below and send it! Use your individual key! 

    Expand
    titleRequest


    Code Block
    languagexml
    <search key="{{your_individual_key}}">
        <inputs>
            <pax adults="1" children="1"/>
            <slice date="2023-12-15" origin="LED" destination="DME"/>
        </inputs>
    </search>



    Expand
    titleResponse


    Code Block
    languagexml
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <result id="bd858aa6-e6e8-42b2-bd68-6b3416fc430a" session="0ff7767d-7505-48b5-9929-8992b627f898" solutionCount="4" solutionSet="ed0d5377-0037-46eb-89f0-abbce67b9896">
        <solutions>
            <itinerary>
                <solution id="0b124e58-d8cb-44f7-96e4-fdd406bf4bf7" saleTotal="RUB9673" preferredFareFamily="CHEAPEST FARE">
                    <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=1010&AC1=S7&DD1=2023-12-15&DT1=12:15:00&AD1=2023-12-15&AT1=13:55:00&DA1=LED&AA1=DME&SC1=N&utm_campaign={{your_utm_campaign}}&utm_campaign={{your_utm_source}}&utm_medium=metasearch&FF1=B">
                        <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                        <SalePriceWithoutYR amount="5062" currency="RUB"/>
                    </ext>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                            <SalePriceWithoutYR amount="5062" currency="RUB"/>
                            <pax adults="1"/>
                        </ext>
                    </pricing>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="4611" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="4611" currency="RUB"/>
                            <SalePriceWithoutYR amount="4611" currency="RUB"/>
                            <pax children="1"/>
                        </ext>
                    </pricing>
                </solution>
                <slice>
                    <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>
                <solution id="9f0d9104-0bf4-4146-927c-ec3b7d81b3a5" saleTotal="RUB9673" preferredFareFamily="CHEAPEST FARE">
                    <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=1012&AC1=S7&DD1=2023-12-15&DT1=15:50:00&AD1=2023-12-15&AT1=17:30:00&DA1=LED&AA1=DME&SC1=N&utm_campaign={{your_utm_campaign}}&utm_campaign={{your_utm_source}}&utm_medium=metasearch&FF1=B">
                        <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                        <SalePriceWithoutYR amount="5062" currency="RUB"/>
                    </ext>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                            <SalePriceWithoutYR amount="5062" currency="RUB"/>
                            <pax adults="1"/>
                        </ext>
                    </pricing>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="4611" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="4611" currency="RUB"/>
                            <SalePriceWithoutYR amount="4611" currency="RUB"/>
                            <pax children="1"/>
                        </ext>
                    </pricing>
                </solution>
                <slice>
                    <segment arrival="2023-12-15T17:30+03:00" carrier="S7" departure="2023-12-15T15:50+03:00" destination="DME" duration="100" flight="S71012" origin="LED"/>
                </slice>
            </itinerary>
            <itinerary>
                <solution id="61737f4a-5b1b-4729-9dce-9bdb36a2d45e" saleTotal="RUB9673" preferredFareFamily="CHEAPEST FARE">
                    <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=1014&AC1=S7&DD1=2023-12-15&DT1=17:00:00&AD1=2023-12-15&AT1=18:40:00&DA1=LED&AA1=DME&SC1=N&utm_campaign={{your_utm_campaign}}&utm_campaign={{your_utm_source}}&utm_medium=metasearch&FF1=B">
                        <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                        <SalePriceWithoutYR amount="5062" currency="RUB"/>
                    </ext>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                            <SalePriceWithoutYR amount="5062" currency="RUB"/>
                            <pax adults="1"/>
                        </ext>
                    </pricing>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="4611" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="4611" currency="RUB"/>
                            <SalePriceWithoutYR amount="4611" currency="RUB"/>
                            <pax children="1"/>
                        </ext>
                    </pricing>
                </solution>
                <slice>
                    <segment arrival="2023-12-15T18:40+03:00" carrier="S7" departure="2023-12-15T17:00+03:00" destination="DME" duration="100" flight="S71014" origin="LED"/>
                </slice>
            </itinerary>
            <itinerary>
                <solution id="0f4e91c7-897a-425e-bf40-dd14a3f10943" saleTotal="RUB9673" preferredFareFamily="CHEAPEST FARE">
                    <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="5062" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                        <SalePriceWithoutYR amount="5062" currency="RUB"/>
                    </ext>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                            <SalePriceWithoutYR amount="5062" currency="RUB"/>
                            <pax adults="1"/>
                        </ext>
                    </pricing>
                    <pricing paxCount="1">
                        <ext>
                            <SalePriceWithoutYQ amount="4611" currency="RUB"/>
                            <SalePriceWithoutYQAndYR amount="4611" currency="RUB"/>
                            <SalePriceWithoutYR amount="4611" currency="RUB"/>
                            <pax children="1"/>
                        </ext>
                    </pricing>
                </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>
        </solutions>
    </result>



    6. If you have no results, try to check your connection to exclude the case of incorrect subnet's IP before you contact to our technical support by mail at api.support@s7.ru

    Anchor
    Step4
    Step4
    Step 4: Running your tests

    1. Choose one of available versions at test environment at the top of the page
    2. Read the API's documentation
    3. Try to execute simplest search use cases and then explore all other available features that you are interested in

    Panel
    • We are using actual flight schedule for both test and production environments. But keep in your mind that not all of our API are using actual schedule on test environment and there's can be some discrepancies between them

    • No time limits for testing

    4. Give us a feedback through our technical support by mail at api.support@s7.ru

    Anchor
    Step5
    Step5
    Step

    4

    5: Access to the production environment

    1. You must provide the ip addresses, subnet from which you will work with the production environment
    2. S7 technicals will add your ip addresses, subnet to the access list and sent notification about that
    3. Try send request and get succesfull response from the production environment

    Step 5: Maintenance

    1. Provide an IP address of a subnet, which you going to use for sending request to the production environment of S7 MSE API, to our technical support by mail at api.support@s7.ru

    2. S7 adds your subnet's IP address to the white access list on the production environment

    3. As soon as our technical support send to you an individual key for requests to the API by mail, you may proceed to production 

    Anchor
    Step6
    Step6
    Step 6: Maintenance

    1. Choose one of available and tested versions at production environment at the top of the page

    2. Use header's parameters for tested selected version (If the parameter is not defined, the default version will be executed):

    3. Try to execute the same tests as for test environment to check the correctness of responses

    4. Don't forget to check our updates!

    Panel
    • Release Notes for new versions of S7 MSE API

    • FAQ for most common issues you can be faced with



    Info

    If you still have any questions, try to find an answer using our FAQ | S7 MSO API and documentation (link (warning)) or ask for technical support by mail email at api.support@s7.ru