To execute a S7 Agent API operations, applications must send an HTTPS POST request to the S7 Agent API endpoint.
For validating your requests that they conform to API's schemas use WSDLs.
S7 Agent API doesn't support compressed request and/or response in GZIP format |
Headers
All requests to S7 Agent API must include the following:
| # | Name | Key in headers | Value |
|---|---|---|---|
| 1 | Version of API | X-API-Version | depends on version of API that you want to execute
|
| 2 | Basic authorization string | Authorization | credentials that you received from our technical support. Check out Quick Start for how to get it |
| 3 | Operation name | SOAPAction | depends on operation that you want to execute |
| 4 | Type of content | Content-Type | always "text/xml" |
If you didn't pass Version of API in request it will execute the default oneS7 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 version API on Test environment:
POST /agent-api/gaia HTTP/1.1 Host: qa-gaia.s7.ru Content-Type: text/xml SOAPAction: "http://api.s7.ru/SearchFlights" X-API-Version: 0.35 Authorization: Basic oV5zbWlyCx92X3M3dfS6dGFpbDpxLTE2OXFs |
Version of API
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 the 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.
| # | Operation | SOAPAction value (actual for v0.35) |
|---|---|---|
| 1 | agentPayment | "http://api.s7.ru/AgentPayment" |
| 2 | baggageCharges | "http://api.s7.ru/BaggageCharges" |
| 3 | book | "http://api.s7.ru/Book" |
| 4 | cancelBooking | "http://api.s7.ru/CancelBooking" |
| 5 | changeBook | "http://api.s7.ru/ChangeBook" |
| 6 | demandTickets | "http://api.s7.ru/DemandTickets" |
| 7 | findRules | "http://api.s7.ru/FindRules" |
| 8 | read | "http://api.s7.ru/Read" |
| 9 | reprice | "http://api.s7.ru/Reprice" |
| 10 | retrieveTicket | "http://api.s7.ru/RetrieveTicket" |
| 11 | searchFlights | "http://api.s7.ru/SearchFlights" |
| 12 | seatMap | "http://api.s7.ru/SeatMap" |
| 13 | servicePrice | "http://api.s7.ru/ServicePrice" |
| 14 | voidTicket | "http://api.s7.ru/VoidTicket" |
