Documentation API

1. Points d'Entrée de l'API

URL de l'API

https://imeaej.ecole-air-espace.fr/api/imeaej

2. Paramètres de Requête

L'API accepte un paramètre de requête optionnel pour spécifier la date de publication de l'image.

date (facultatif) : La date sous le format YYYY-MM-DD. Si aucune date n'est spécifiée, la date actuelle sera utilisée.

3. Exemple de Requête

Pour obtenir l'image pour une date spécifique, vous pouvez faire une requête HTTP GET comme suit :

Exemple de requête pour obtenir l'image du 12 mai 2025 :

GET https://imeaej.ecole-air-espace.fr/api/imeaej?date=2025-05-12

4. Réponse de l'API

L'API renvoie une réponse au format JSON contenant les informations sur l'image pour la date demandée.

Exemple de réponse JSON pour une image :

{ "image_url": "https://imeaej.ecole-air-espace.fr/Site_ImEaeJ/Images_eae_db/2024_A701_297_L_001_062.jpg", "titre": "Baptême dans le vent des hélices de la promotion 2024 de l'EAE", "explication": "L’objectif de ce premier baptême, plaçant les poussins à genoux derrière Le Noratlas de Provence, est de rappeler à ces derniers les débuts héroïques de l’aviation puisqu’ils ressentent ainsi les mêmes sensations que les premiers aviateurs.", "auteur": "L. PUYBONNIEUX / Armée de l'Air et de l'Espace", "date_publication": "2025-05-12" }

5. Explication des Champs dans la Réponse

image_url : L'URL de l'image.
titre : Le titre de l'image.
explication : Une brève explication de l'image. Si aucune explication n'est fournie, un message par défaut sera renvoyé.
auteur : Le crédit de l'image.
date_publication : La date à laquelle l'image a été publiée.

6. Codes de Réponse

Les réponses de l'API peuvent inclure les codes suivants :

200 OK: La requête a été traitée avec succès et l'image est renvoyée.
404 Not Found: Aucune image disponible pour la date spécifiée.
500 Internal Server Error: Il y a eu un problème avec la connexion à la base de données.

7. Remarques importantes

Encodage des données: Toutes les données sont retournées en UTF-8 pour assurer la compatibilité avec les caractères spéciaux et multilingues.
Format des dates: Assurez-vous de fournir la date dans le format YYYY-MM-DD pour éviter toute erreur dans la requête.
Images: Les images sont récupérées via une URL publique accessible sur le serveur. Assurez-vous que l'image est disponible sur le serveur avant de faire la requête.

8. Mise en garde sur l’utilisation de l’API

ImEaeJ propose une interface permettant d’accéder aux images du jour via une API. Toutefois, l’École de l’air et de l’espace n’est pas responsable des extensions, applications ou services développés par des tiers qui pourraient utiliser cette API, notamment pour proposer des solutions automatisées de mise à jour de fonds d’écran sur ordinateurs, tablettes ou téléphones mobiles.

Ces outils externes ne sont ni vérifiés, ni validés, ni maintenus par l’École de l’air et de l’espace. Les utilisateurs sont seuls responsables de l’usage qu’ils font de ces solutions tierces, et doivent faire preuve de vigilance quant à la sécurité et à la fiabilité des outils qu’ils choisissent d’utiliser.

9. Support

Si vous rencontrez des problèmes avec l'API ou avez des questions, n'hésitez pas à nous contacter à l'adresse suivante : community.manager@ecole-air.fr.