Versions Compared

Old Version 4

changes.mady.by.user Pavel A. Smirnov (Deactivated)

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.

Steps

  1. 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. 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 MSE API and stay tuned for a new features!

Target period — 7 working days

Anchor
environment
environment

Environment

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

Anchor
Step1
Step1
Step 1: Come to an agreement for connection

  1. Contact to 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. Provide an IP address of a subnet, which you going to use for sending request to the test environment

    of S7

    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

    on the test environment

  3. As soon as our technical support send to you an individual key for requests to the

    API by

    API by mail, you may proceed to tests

Anchor
Step3
Step3
Step 3: Hello world!

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

Panel

Download the last binary version of SoapUI Postman at https://www.soapuipostman.orgcom/downloads/soapui.html and  and install software

2. Open SoapUI  Open Postman and create a new REST project

Panel
  1. SoapUI → File → Preferences → New SOAP project

    Postman → New → HTTP

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

  3. Copy relevant Endpoint

  4. Past in form, fill a project name and press OK

3. Set method — POST

4. Set headers in Header tab:

true
Code Block
linenumbers
Content-Type: text/xml
X-API-Version: 0.3552

5. Fill in the request textarea by an example described below and send it! Excerpt IncludeOW + 1xADT + Transit + S7 flight | S7 MSE APIOW + 1xADT + Transit + S7 flight | S7 MSE APInopaneltrueUse 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 technical support by mail at api.support@s7.ru

Anchor
Step4
Step4
Step 4: Running your tests

1. Choose one of available versions

at 

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 5: Access to the production environment

  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 test

    on the production environment

  3. As soon as our technical support send to you an individual key for requests to the

    API by

    API by mail, you may proceed to production 

Anchor
Step6
Step6
Step 6: Maintenance

  1. Choose one of available and tested versions

    2. at 

  2. at production environment at the top of the page

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

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

  5. Don't forget to check our updates!

Panel

  • Release Notes for new versions of S7

    Agent

    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 and documentation or ask for technical support by email at api.support@s7.ru