Récupération des vols par un logiciel tiers: Difference between revisions
Jump to navigation
Jump to search
imported>Claratte (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... ») |
imported>Jcheng |
||
Line 15: | Line 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é | * 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. | ||
Line 23: | Line 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"> | ||
<input type="hidden" name="arguments[0]" value="getLastActivity" /> | <input type="hidden" name="arguments[0]" value="getLastActivity" /> | ||
<label>Clé :</label> | <label>Clé :</label> | ||
<br/> | <br/> | ||
Line 34: | Line 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" /> |
Revision as of 16:17, 27 October 2016
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 :
<html4Strict><form action="https://demo-fr.openflyers.fr/actionOnDemand.php" method="post">
<input type="hidden" name="arguments[0]" value="getLastActivity" /> <label>Clé :</label>
<input type="text" name="key" value="" />
<label>Limite :</label>
<input type="text" name="number" value="1" />
<label>Date de début (AAAA-MM-JJ) :</label>
<input type="text" name="startDate" value="" />
<label>Date de fin (AAAA-MM-JJ) :</label>
<input type="text" name="endDate" value="" />
<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>
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)