You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Current »

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

Environment




Test

Production

1

Version

Endpoint

Endpoint

2

0.52

Default

Default

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

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

Step 3: Hello world!

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

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

  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:

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! 


<search key="*********************">
    <inputs>
        <pax adults="1" children="1"/>
        <slice date="2023-12-15" origin="LED" destination="DME"/>
    </inputs>
</search>


<?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

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

  • 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

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

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!

  • Release Notes for new versions of S7 MSE API

  • FAQ for most common issues you can be faced with



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

  • No labels