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

Aller à : navigation, rechercher
(Page créée avec « =Présentation= L'objet de cette page est de décrire la récupération des vols par un logiciel tiers. La récupération est réalisée à l'aide d'un Wikipedia-fr:Ser... »)
 
(Interfaçage avec OpenFlyers)
Ligne 15 : Ligne 15 :
 
** '''key''' : La clé de sécurité du service web.
 
** '''key''' : La clé de sécurité du service web.
 
** '''number''' : Le nombre de vols à récupérer
 
** '''number''' : Le nombre de vols à récupérer
 +
** '''startDate''' : La date de début des vols à récupérer. Ce paramètre est optionnel et doit être au format AAAA-MM-JJ
 +
** '''endDate''' : La date de fin des vols à récupérer. Ce paramètre est optionnel et doit être au format AAAA-MM-JJ
  
 
Le service web va renvoyer soit :
 
Le service web va renvoyer 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
+
* Un message d'interdiction d'accès lorsque l'un de ces conditions est rencontrée :
 +
** le protocole de communication HTTP est employé  
 +
** la clé de sécurité n'est pas bonne
 +
** La date de début est renseignée et la date de fin de l'est pas. Une date de début/fin qui n'est pas au bon format et considérée comme étant non renseignée
 +
** La date de fin est renseignée et la date de début ne l'est pas. Une date de début/fin qui n'est pas au bon format et considérée comme étant non renseignée
 +
** La date de début et de fin sont toutes les deux renseignées et il y a un écart de plus de 32 jours entre ces dates
 
* La liste des X derniers vols au format JSON.
 
* La liste des X derniers vols au format JSON.
  
Ligne 23 : Ligne 30 :
 
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 vols :
 
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 vols :
 
<html4Strict><form action="https://demo-fr.openflyers.fr/actionOnDemand.php" method="post">
 
<html4Strict><form action="https://demo-fr.openflyers.fr/actionOnDemand.php" method="post">
    <label>Service web :</label>
 
    <br/>
 
 
     <input type="hidden" name="arguments[0]" value="getLastActivity" />
 
     <input type="hidden" name="arguments[0]" value="getLastActivity" />
    <br/>
 
 
     <label>Clé :</label>
 
     <label>Clé :</label>
 
     <br/>
 
     <br/>
Ligne 34 : Ligne 38 :
 
     <br/>
 
     <br/>
 
     <input type="text" name="number" value="1" />
 
     <input type="text" name="number" value="1" />
 +
    <br/>
 +
    <label>Date de début (AAAA-MM-JJ) :</label>
 +
    <br/>
 +
    <input type="text" name="startDate" value="" />
 +
    <br/>
 +
    <label>Date de fin (AAAA-MM-JJ) :</label>
 +
    <br/>
 +
    <input type="text" name="endDate" value="" />
 
     <br/>
 
     <br/>
 
     <input type="submit" value="Test" />
 
     <input type="submit" value="Test" />

Version du 27 octobre 2016 à 17:17

Présentation

L'objet de cette page est de décrire la récupération des vols par un logiciel tiers. La récupération est réalisée à l'aide d'un service web.

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 la plateforme concernée :
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 service web.
    • number : Le nombre de vols à récupérer
    • startDate : La date de début des vols à récupérer. Ce paramètre est optionnel et doit être au format AAAA-MM-JJ
    • endDate : La date de fin des vols à récupérer. Ce paramètre est optionnel et doit être au format AAAA-MM-JJ

Le service web va renvoyer soit :

  • Un message d'interdiction d'accès lorsque l'un de ces conditions est rencontrée :
    • le protocole de communication HTTP est employé
    • la clé de sécurité n'est pas bonne
    • La date de début est renseignée et la date de fin de l'est pas. Une date de début/fin qui n'est pas au bon format et considérée comme étant non renseignée
    • La date de fin est renseignée et la date de début ne l'est pas. Une date de début/fin qui n'est pas au bon format et considérée comme étant non renseignée
    • La date de début et de fin sont toutes les deux renseignées et il y a un écart de plus de 32 jours entre ces dates
  • 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 vols :

<form action="https://demo-fr.openflyers.fr/actionOnDemand.php" method="post">
    <input type="hidden" name="arguments[0]" value="getLastActivity" />
    <label>Clé :</label>
    <br/>
    <input type="text" name="key" value="" />
    <br/>
    <label>Limite :</label>
    <br/>
    <input type="text" name="number" value="1" />
    <br/>
    <label>Date de début (AAAA-MM-JJ) :</label>
    <br/>
    <input type="text" name="startDate" value="" />
    <br/>
    <label>Date de fin (AAAA-MM-JJ) :</label>
    <br/>
    <input type="text" name="endDate" value="" />
    <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"
    }
]

Paramétrer la clé de sécurité

  • Menu Admin > Configuration > Paramétrage
  • Aller dans le bloc Gestion générale
  • Saisir le champ Clé de service web (lorsque requis)