Versions Compared

Old Version 2

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,

you submit

applications must send an HTTPS

request

POST request to the

QPX

S7 Agent API endpoint.

Request

Applications must send an HTTPS POST request.

All requests to S7 Agent API must include the following:

  • Version of API (the "X-API-Version" key in headers) – check Environment table for a value below
    • Basic authorization string (the "Authorization" key in headers) — credentials that you received from our technical support. Check

    Environments

    Follow steps to quickly get an access to API

    Excerpt




    		TestProduction
    #VersionEndpointEndpoint
    10.52WSDL

    WSDL

    2up torefund&deleteTST&schedule&split&postsalerefund&deleteTST&schedule
    3up to

    queue

    queue

     


    Table of contents:

    Table of Contents

    Schemas

    S7 Agent API makes WSDLs for all of 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. 

    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 name
    (the "SOAPAction" key in headers) — check Operation table for a value below
    RequiredSOAPActionDepends on operation that you want to execute
    4Type of content
    (the "
    RequiredContent-Type
    " key in headers) — always
    Sets the content type of the request. Always "text/xml"
    NoteS7 Agent API doesn't support compressed request and/or response in GZIP format

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

    For validating your requests that they conform to API's schemas use WSDLs. Links provided in Environment table.

    Version of API

    The following example shows headers of a typical SearchFlights operation of 0.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/SearchFlightsJourney"
X-API-Version: 0.52
Authorization: Basic *********************

    Versions

    You can use any released

    You can use other

    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

    it will be execute the default.

    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"

    Response

    Identifying requested version of API

    Successful results

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

    Table of contents:

    Table of Contents

    Environment

    ExcerptTestProduction#VersionEndpointEndpoint10.21WSDL(tick)WSDL(tick)20.35WSDL(error)

    (tick) — default version for environment

    (error) — not installed on environment

    Note

    If you are ready to a new versions which are not installed on production environment — notify our technical support by JIRA

    NoteFollow steps to quickly get an access to API