Récupération des vols par un logiciel tiers : Différence entre versions

Aller à : navigation, rechercher
(→‎Récupérer les X derniers vols)
(→‎Interfaçage avec OpenFlyers)
Ligne 8 : Ligne 8 :
  
 
Pour accéder à ce webservice, il faut :
 
Pour accéder à ce webservice, il faut :
 +
* Utiliser le protocole de communication HTTPS
 
* Appeler l'URL ci-dessous en remplaçant "maplateforme" par le nom de votre plateforme :
 
* Appeler l'URL ci-dessous en remplaçant "maplateforme" par le nom de votre plateforme :
 
<pre>https://maplateforme.openflyers.fr/actionOnDemand.php</pre>
 
<pre>https://maplateforme.openflyers.fr/actionOnDemand.php</pre>
Ligne 15 : Ligne 16 :
 
** '''number''' : Le nombre de vol à récupérer
 
** '''number''' : Le nombre de vol à récupérer
  
−
Le webservice retournera la liste des X derniers vols au format JSON.
+
Le webservice se chargera de retourner soit :
 +
* Un message d'interdiction d'accès lorsque le protocole de communication HTTP est employé ou que la clé de sécurité n'est pas bonne
 +
* La liste des X derniers vols au format JSON.
 +
 
 +
 
 +
Exemple de formulaire pour récupérer les derniers vols sur la plateforme demo-fr.openflyers.fr où on demande la clé et le nombre de vol :
 +
<html4Strict><form action="https://demo-fr.openflyers.fr/actionOnDemand.php" method="post">
 +
    <label>Webservice :</label>
 +
    <br/>
 +
    <input type="hidden" name="arguments[0]" value="getLastActivity" />
 +
    <br/>
 +
    <label>Clé :</label>
 +
    <br/>
 +
    <input type="text" name="key" value="" />
 +
    <br/>
 +
    <label>Limite :</label>
 +
    <br/>
 +
    <input type="text" name="number" value="1" />
 +
    <br/>
 +
    <input type="submit" value="Test" />
 +
</form></html4Strict>
 +
 
 +
Exemple de de retour :
 +
<javascript>[
 +
    {
 +
        "first_person":"MUZIKA Joseph",
 +
        "start_date":"2016-10-19 08:30:00",
 +
        "second_person":"",
 +
        "departure_location_name":"LFRB",
 +
        "end_date":"2016-10-19 09:30:00",
 +
        "arrival_location_name":"LFRB",
 +
        "duration":"1:00",
 +
        "landing_number":"2",
 +
        "resource_name":"F-HIAE"
 +
    },
 +
    {
 +
        "first_person":"OLLIVIER Gabriel",
 +
        "start_date":"2016-10-18 15:16:00",
 +
        "second_person":"",
 +
        "departure_location_name":null,
 +
        "end_date":"2016-10-18 16:46:00",
 +
        "arrival_location_name":null,
 +
        "duration":"1:30",
 +
        "landing_number":"1",
 +
        "resource_name":"Simu F-DSIM"
 +
    }
 +
]<javascript>

Version du 19 octobre 2016 à 15:14

Présentation

L'objet de cette page décrit la récupération des vols par un logiciel tiers.

Interfaçage avec OpenFlyers

La récupération des X derniers vols se fait à l'aide du webservice getLastActivity.

Pour accéder à ce webservice, il faut :

  • Utiliser le protocole de communication HTTPS
  • Appeler l'URL ci-dessous en remplaçant "maplateforme" par le nom de votre plateforme :
https://maplateforme.openflyers.fr/actionOnDemand.php
  • Transmettre les paramètres suivantes par méthode POST :
    • arguments[0] : getLastActivity
    • key : La clé de sécurité du webservice
    • number : Le nombre de vol à récupérer

Le webservice se chargera de retourner soit :

  • Un message d'interdiction d'accès lorsque le protocole de communication HTTP est employé ou que la clé de sécurité n'est pas bonne
  • La liste des X derniers vols au format JSON.


Exemple de formulaire pour récupérer les derniers vols sur la plateforme demo-fr.openflyers.fr où on demande la clé et le nombre de vol : 

<form action="https://demo-fr.openflyers.fr/actionOnDemand.php" method="post">
    <label>Webservice :</label>
    <br/>
    <input type="hidden" name="arguments[0]" value="getLastActivity" />
    <br/>
    <label>Clé :</label>
    <br/>
    <input type="text" name="key" value="" />
    <br/>
    <label>Limite :</label>
    <br/>
    <input type="text" name="number" value="1" />
    <br/>
    <input type="submit" value="Test" />
</form>

Exemple de de retour : 

[
    {
        "first_person":"MUZIKA Joseph",
        "start_date":"2016-10-19 08:30:00",
        "second_person":"",
        "departure_location_name":"LFRB",
        "end_date":"2016-10-19 09:30:00",
        "arrival_location_name":"LFRB",
        "duration":"1:00",
        "landing_number":"2",
        "resource_name":"F-HIAE"
    },
    {
        "first_person":"OLLIVIER Gabriel",
        "start_date":"2016-10-18 15:16:00",
        "second_person":"",
        "departure_location_name":null,
        "end_date":"2016-10-18 16:46:00",
        "arrival_location_name":null,
        "duration":"1:30",
        "landing_number":"1",
        "resource_name":"Simu F-DSIM"
    }
]<javascript>