Versions Compared

Old Version 11

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.

To execute

a

S7 Agent API operations, applications must send an HTTPS POST request to the S7 Agent API endpoint.

Note

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

Table of contents:

Table of Contents

Environments

Environments

Follow steps to quickly get an access to API

Excerpt




TestProduction
#VersionEndpointEndpoint
10.
21
52WSDL
Default

WSDL

Default

2
0.35WSDLNot installed Note
  • Follow steps to quickly get an access to API
    • If you are ready to a new versions which are not installed on production environment — notify our
    up torefund&deleteTST&schedule&split&postsalerefund&deleteTST&schedule
    3up to

    queue

    queue

     


    Table of contents:

    Table of Contents

    technical support by JIRA

    Schemas

    S7 Agent API makes WSDLs for most all of major versions available for download.

    When you are developing S7 Agent API applications that send requests and receive responses, you might find it helpful to validate the contents of your messages against the relevant schema. The schemas are provided only for versions of APIs where it was changed. For example, if the 0.21 version of API includes WSDL link and the 0.26 isn't, then the schema of 0.21 conform for both those API versions.

    Headers

    The following table describes the HTTP headers that you typically set in a S7 Agent API request:

    #NameMandatoryKey in headersDescription
    1Version of APIOptionalX-API-Version

    Depends on version of API that you want to execute

    (warning) If you didn't pass Version of API in request a default one will be executed

    2Basic authorization stringRequiredAuthorizationCredentials that you received from our S7 technical support. Check out Quick Start for how to get it
    3Operation nameRequiredSOAPActionDepends on operation that you want to execute
    4Type of contentRequiredContent-TypeSets the content type of the request. Always "text/xml"

    S7 agent API required encrypted HTTP requests via HTTPS only. Check out Quick Start for how to get SSL certificate.

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

    Code Block
    linenumberstrue
    POST /agent-api/gaia HTTP/1.1
Host: qa-gaia.s7.ru
Content-Type: text/xml
SOAPAction: "http://api.s7.ru/SearchFlightsSearchFlightsJourney"
X-API-Version: 0.3552
Authorization: Basic oV5zbWlyCx92X3M3dfS6dGFpbDpxLTE2OXFs*********************

    Versions

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

    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.

    #OperationSOAPAction value (actual for v0.
    35
    52)
    1
    agentPayment
    book"http://api.s7.ru/
    AgentPayment
    Book"
    2
    baggageCharges
    cancelBooking"http://api.s7.ru/
    BaggageCharges
    CancelBooking"
    3
    book
    changeBook
    		"http://api.s7.ru/
    Book
    ChangeBook"
    4
    cancelBooking
    demandTickets"http://api.s7.ru/
    CancelBooking
    DemandTickets"
    5
    changeBook
    flightInfo"http://api.s7.ru/
    ChangeBook
    FlightInfo"
    6
    demandTickets
    orderCreate "http://api.s7.ru/
    DemandTickets
    OrderCreate"
    7
    findRules
    orderChange"http://api.s7.ru/
    FindRules
    OrderChange"
    8read"http://api.s7.ru/Read"
    9reprice"http://api.s7.ru/Reprice"
    10retrieveTicket"http://api.s7.ru/RetrieveTicket"
    11
    searchFlights
    retrieve TST"http://api.s7.ru/
    SearchFlights
    RetrieveTST"
    12searchFlightsFlex"http://api.s7.ru/SearchFlightsFlex"
    13searchFlightsBySlice"http://api.s7.ru/SearchFlightsBySlice"
    14searchFlightsJourney"http://api.s7.ru/SearchFlightsJourney"
    15seatMap"http://api.s7.ru/SeatMap"
    13
    16servicePrice"http://api.s7.ru/ServicePrice"
    14
    17voidTicket"http://api.s7.ru/VoidTicket"
    18schedule"http://api.s7.ru/agent/ndc/get-schedule"
    19postsale"http://api.s7.ru/agent/ndc/add-postsell-ancillaries"

    Common questions

    Excerpt Include
    Common | FAQ
    Common | FAQ
    nopaneltrue