====== Flight info ======

This is flight information method. It retrieves information about departure and arrival flight with times.

It is required that you enter trip hash code when checking flight times.
===== Valid content types =====

  * ''pauschal''
  * ''charter''
  * ''oneway''
  * (''hotel'' **is not supported**)
  * (''trips'' **is not supported**)

===== Description =====

<code php>
public array flightInfo( array $searchData, array $headerData )
</code>

===== Parameters =====

  * ''searchData (array)'' : search parameters. Required serach parameters: ''toc'', ''ahc'', ''zhc'', ''hsc''
  * ''headerData (array)'' : [[soap_header|SOAP Header Information]]


===== Return Values =====

Returns flight information in array format and in a text format (info). Some touroperators don't support array format.

<code>
Array
(
    [response] => Array
        (
            [mid] => 998
            [txt] => 
            [status] => 1
        )

    [times] => Array
        (
            [0] => Array
                (
                    [id] => 1
                    [tok] => 
                    [drc] => 0
                    [fla] => Niki
                    [ahc] => VIE
                    [zhc] => PMI
                    [flc] => HG
                    [fln] => 7794
                    [dpd] => 19.10.2014
                    [dpt] => 1135
                    [ard] => 19.10.2014
                    [art] => 1400
                    [sec] => 
                    [ahn] => Wien
                    [zhn] => Mallorca
                    [logo] => http://www.ors.si/ibe/images/airline_logos/hg.gif
                )

            [1] => Array
                (
                    [id] => 2
                    [tok] => 
                    [drc] => 1
                    [fla] => Niki
                    [ahc] => PMI
                    [zhc] => VIE
                    [flc] => HG
                    [fln] => 7795
                    [dpd] => 24.10.2014
                    [dpt] => 2050
                    [ard] => 24.10.2014
                    [art] => 2310
                    [sec] => 
                    [ahn] => Mallorca
                    [zhn] => Wien
                    [logo] => http://www.ors.si/ibe/images/airline_logos/hg.gif
                )

            [2] => Array
                (
                    [id] => 3
                    [tok] => 
                    [drc] => 1
                    [fla] => Niki
                    [ahc] => PMI
                    [zhc] => VIE
                    [flc] => HG
                    [fln] => 3253
                    [dpd] => 24.10.2014
                    [dpt] => 2045
                    [ard] => 24.10.2014
                    [art] => 2305
                    [sec] => 
                    [ahn] => Mallorca
                    [zhn] => Wien
                    [logo] => http://www.ors.si/ibe/images/airline_logos/hg.gif
                )

            [3] => Array
                (
                    [id] => 4
                    [tok] => 
                    [drc] => 0
                    [fla] => Niki
                    [ahc] => VIE
                    [zhc] => PMI
                    [flc] => HG
                    [fln] => 3252
                    [dpd] => 19.10.2014
                    [dpt] => 0530
                    [ard] => 19.10.2014
                    [art] => 0755
                    [sec] => 
                    [ahn] => Wien
                    [zhn] => Mallorca
                    [logo] => http://www.ors.si/ibe/images/airline_logos/hg.gif
                )

        )

    [info] => Array
        (
            [0] => Voraussichtliche Flugdaten :
            [1] => WIEN - PALMA DE MALLORCA - WIEN
            [2] => 
            [3] => Strecke Datum      Abflug Ankunft Flugnr    Free ST Flugcode
            [4] => VIE PMI 19.10.14   11:35  14:00   HG7794    1PC  OK 4S7794A7
            [5] => PMI VIE 24.10.14   20:50  23:10   HG7795    1PC  OK 4S7795A5
            [6] => 
            [7] => VIE PMI 19.10.14   11:35  14:00   HG7794    1PC  OK 4S7794A7
            [8] => PMI VIE 24.10.14   20:45  23:05   HG3253    1PC  OK 4S3253A5
            [9] => 
            [10] => VIE PMI 19.10.14   05:30  07:55   HG3252    1PC  OK 4S3252A7
            [11] => PMI VIE 24.10.14   20:50  23:10   HG7795    1PC  OK 4S7795A5
            [12] => VORAUSSICHTLICHE FLUGZEITEN
            [13] => CRS made with love by traffics.de
        )

    [xmlReq] => 
)
</code>

===== Return parameters =====

  * ''response'' (array) : response message
    * ''mid'' : message ID
    * ''txt'' : message text
    * ''status'' : status indicator (1 - flight data available; 0 - no flight data)
  * ''times'' (arrary) : flight times in array format
    * ''id'' : sequence number
    * ''tok'' : (reserved)
    * ''drc'' : (reserved)
    * ''sec'' : (reserved)
    * ''fla'' : flight carrier name
    * ''ahc'' : departure airport code
    * ''ahn'' : departure airport name
    * ''zhc'' : arrival airport code
    * ''zhn'' : arrival airport name
    * ''flc'' : flight carrier code
    * ''fln'' : flight number
    * ''dpd'' : departure date
    * ''dpt'' : departure time
    * ''ard'' : arrival date
    * ''art'' : arrival time
    * ''logo'' : airline logo
  * ''info'' (array) : info lines about flight information. In most cases flight information is shown info

===== Examples =====

  * Example of flight info check

<code php>
$searchParams = array(
    'toc' => 'SLR',    // touroperator code
    'ahc' => 'VIE',    // departure airport code
    'zhc' => 'PMI',    // arrival airport code
    'hsc' => 'X63P001FD80009:0000004B000002A4000A93EA0',   // trip unique hash code
);

// flight info
$flight = $soapClient->orsxml_pauschal_api_call( 'flightInfo', $searchParams, $headerData );
</code>

===== JSON Examples =====

@see [[ors-soap-api:public:json_api]] how to post request.

<code php>
{
  "requestType" : "info",
  "action": "flightInfo",
  "search": {
    "hsc": "X71P0006A00007:0000000100000019400C8348D11",
    "toc": "5VF",
    "ahc": "MUC",
    "zhc": "AYT",
    "epc": "2"
  },
  "header": {
    "lang": "[lang]",
    "usr" : "[usr]",
    "pass": "[pass]",
    "agid": "[agid]"
  }
}
</code>