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. MSE API doesn't have WSDL, but it's coming soon — regularly check release notes and stay in touch. You can check samples and references for all request and response.
Headers
The following table describes the HTTP headers that you typically set in a S7 Agent MSE API request:
| # | Name | Mandatory | Key in headers | Description |
|---|---|---|---|---|
| 1 | Version of API | Optional | X-API-Version | Depends on version of API that you want to execute
|
| 2 | Basic authorization string | Required | Authorization | Credentials that you received from our S7 technical support. Check out Quick Start for how to get it |
| 3 | Operation name | Required | SOAPAction | Depends on operation that you want to execute |
| 4 | Type of content | Required | Content-Type | Sets the content type of the request. Always "text/xml" |
If you didn't pass Version of API in request a default one will be executedS7 agent MSR 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 request of 0.35 version API on Test environment:
| Code Block | ||
|---|---|---|
| ||
POST /agent-api/gaiamse HTTP/1.1 Host: qa-gaiaapi.s7s7airlines.rucom Content-Type: text/xml SOAPAction: "http://api.s7.ru/SearchFlights" X-API-Version: 0.35 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 namesApplications must send the "SOAPAction" key in headers of request to the S7 Agent API for determination of operation.
Common questions
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|