# amabnl/amadeus-ws-client architecture

> Architecture diagram of the GitHub repository amabnl/amadeus-ws-client, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amabnl/amadeus-ws-client
- Repository: https://github.com/amabnl/amadeus-ws-client

## Overview

This is a PHP client library for Amadeus GDS SOAP services. Callers provide typed request options through the Client API; the client creates a versioned SOAP request, sends it through a session handler, analyzes the response, and returns a Result. The repository also exposes broad booking, ticketing, fare, payment, queue, reporting, and related message families. The principal orchestration is visible in the Client excerpt; several feature-family implementation links are documented or suggested by the tree but their runtime wiring was not sampled.

Main entry points: [`src/Amadeus/Client/RequestOptions`](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestOptions) (Request Options), [`src/Amadeus/Client.php`](https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client.php) (Client), [`src/Amadeus/Client/Session/Handler`](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/Session/Handler) (Session Handler), [`src/Amadeus/Client/RequestCreator`](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator) (Request Creator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Client API"]
  node_client["Client<br/>[Client.php]"]
  node_params["Client Parameters<br/>[Params.php]"]
  node_options["Request Options"]
end

subgraph group_request["Request Construction"]
  node_creator["Request Creator"]
  node_converters["Message Converters"]
  node_structs["SOAP Message Structs"]
end

subgraph group_transport["SOAP Session"]
  node_session["Session Handler"]
  node_soap{{"Amadeus SOAP Service"}}
  node_soapclient["SOAP Client Adapter<br/>[SoapClient.php]"]
end

subgraph group_domains["Service Domains"]
  node_air["Air Booking"]
  node_fare["Fare Search"]
  node_pnr["PNR Management"]
  node_ticket["Ticketing"]
  node_other_services["Other Services"]
end

subgraph group_response["Response Processing"]
  node_dispatch["Response Dispatch"]
  node_standard["Standard Handler"]
  node_special_handlers["Specialized Handlers"]
  node_result["Result<br/>[Result.php]"]
  node_messages["Error Messages<br/>[NotOk.php]"]
end

node_caller(("Library Caller"))

node_caller -->|"calls"| node_client
node_client -->|"creates request"| node_creator
node_client -->|"sends message"| node_session
node_client -->|"analyzes response"| node_dispatch
node_creator -.->|"uses converters"| node_converters
node_converters -.->|"builds messages"| node_structs
node_session -.->|"exchanges SOAP"| node_soap
node_session -.->|"uses adapter"| node_soapclient
node_special_handlers -->|"extends handler"| node_standard
node_standard -->|"creates results"| node_result
node_special_handlers -->|"creates results"| node_result
node_result -->|"contains messages"| node_messages
node_options -.->|"supplies options"| node_creator
node_air -.->|"accepts inputs"| node_options
node_fare -.->|"accepts inputs"| node_options
node_pnr -.->|"accepts inputs"| node_options
node_ticket -.->|"accepts inputs"| node_options
node_other_services -.->|"accepts inputs"| node_options

click node_client "https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client.php"
click node_params "https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/Params.php"
click node_options "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestOptions"
click node_creator "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator"
click node_converters "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter"
click node_structs "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/Struct"
click node_session "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/Session/Handler"
click node_soapclient "https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/SoapClient.php"
click node_air "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/Air"
click node_fare "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/Fare"
click node_pnr "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/PNR"
click node_ticket "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/Ticket"
click node_other_services "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter"
click node_dispatch "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/ResponseHandler"
click node_standard "https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/ResponseHandler/StandardResponseHandler.php"
click node_special_handlers "https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/ResponseHandler"
click node_result "https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/Result.php"
click node_messages "https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/Result/NotOk.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client,node_params,node_options toneBlue
class node_creator,node_converters,node_structs toneAmber
class node_session,node_soap,node_soapclient toneMint
class node_air,node_fare,node_pnr,node_ticket,node_other_services toneRose
class node_dispatch,node_standard,node_special_handlers,node_result,node_messages,node_caller toneIndigo
```

## Components

### Client API

- [Client](https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client.php): `src/Amadeus/Client.php`
- [Client Parameters](https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/Params.php): `src/Amadeus/Client/Params.php`
- [Request Options](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestOptions): `src/Amadeus/Client/RequestOptions`

### Request Construction

- [Request Creator](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator): `src/Amadeus/Client/RequestCreator`
- [Message Converters](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter): `src/Amadeus/Client/RequestCreator/Converter`
- [SOAP Message Structs](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/Struct): `src/Amadeus/Client/Struct`

### SOAP Session

- [Session Handler](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/Session/Handler): `src/Amadeus/Client/Session/Handler`
- **Amadeus SOAP Service**
- [SOAP Client Adapter](https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/SoapClient.php): `src/Amadeus/Client/SoapClient.php`

### Service Domains

- [Air Booking](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/Air): `src/Amadeus/Client/RequestCreator/Converter/Air`
- [Fare Search](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/Fare): `src/Amadeus/Client/RequestCreator/Converter/Fare`
- [PNR Management](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/PNR): `src/Amadeus/Client/RequestCreator/Converter/PNR`
- [Ticketing](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter/Ticket): `src/Amadeus/Client/RequestCreator/Converter/Ticket`
- [Other Services](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/RequestCreator/Converter): `src/Amadeus/Client/RequestCreator/Converter`

### Response Processing

- [Response Dispatch](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/ResponseHandler): `src/Amadeus/Client/ResponseHandler`
- [Standard Handler](https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/ResponseHandler/StandardResponseHandler.php): `src/Amadeus/Client/ResponseHandler/StandardResponseHandler.php`
- [Specialized Handlers](https://github.com/amabnl/amadeus-ws-client/tree/master/src/Amadeus/Client/ResponseHandler): `src/Amadeus/Client/ResponseHandler`
- [Result](https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/Result.php): `src/Amadeus/Client/Result.php`
- [Error Messages](https://github.com/amabnl/amadeus-ws-client/blob/master/src/Amadeus/Client/Result/NotOk.php): `src/Amadeus/Client/Result/NotOk.php`

### Other components

- **Library Caller**

## Connections

- Library Caller → Client: calls
- Client → Request Creator: creates request (evidence: `src/Amadeus/Client.php`)
- Client → Session Handler: sends message (evidence: `src/Amadeus/Client.php`)
- Client → Response Dispatch: analyzes response (evidence: `src/Amadeus/Client.php`)
- Request Creator → Message Converters: uses converters (evidence: `src/Amadeus/Client/RequestCreator/Converter/SalesReports/DisplayQueryReportConv.php`)
- Message Converters → SOAP Message Structs: builds messages (evidence: `src/Amadeus/Client/RequestCreator/Converter/SalesReports/DisplayQueryReportConv.php`)
- Session Handler → Amadeus SOAP Service: exchanges SOAP
- Session Handler → SOAP Client Adapter: uses adapter
- Specialized Handlers → Standard Handler: extends handler (evidence: `src/Amadeus/Client/ResponseHandler/Fare/HandlerMasterPricerTravelBoardSearch.php`)
- Standard Handler → Result: creates results (evidence: `src/Amadeus/Client/ResponseHandler/StandardResponseHandler.php`)
- Specialized Handlers → Result: creates results (evidence: `src/Amadeus/Client/ResponseHandler/Air/HandlerRetrieveSeatMap.php`)
- Result → Error Messages: contains messages (evidence: `src/Amadeus/Client/ResponseHandler/Air/HandlerRetrieveSeatMap.php`)
- Request Options → Request Creator: supplies options (evidence: `src/Amadeus/Client/RequestCreator/Converter/SalesReports/DisplayQueryReportConv.php`)
- Air Booking → Request Options: accepts inputs
- Fare Search → Request Options: accepts inputs
- PNR Management → Request Options: accepts inputs
- Ticketing → Request Options: accepts inputs
- Other Services → Request Options: accepts inputs (evidence: `src/Amadeus/Client/RequestCreator/Converter/SalesReports/DisplayQueryReportConv.php`)
