Le service AMSAT Satellite Status, outil pour suivre l’état de la flotte spatiale, fait peau neuve avec le déploiement de son API version 1.2. Cette mise à jour majeure s’accompagne d’un changement d’URL et d’une architecture modernisée. Elle permet aux développeurs de logiciels de suivi et aux opérateurs de consulter plus efficacement le catalogue des satellites, de filtrer les rapports d’écoute et de soumettre leurs propres observations.

La refonte introduit des standards actuels pour les développeurs tout en préservant l’accès aux anciens systèmes. Les évolutions factuelles incluent :
- Nouvelle URL de base : Les requêtes doivent désormais pointer vers
[https://status.amsat.org/api/v1](https://status.amsat.org/api/v1).

- Documentation OpenAPI (Swagger) : L’API intègre un fichier OpenAPI (
/openapi.php) consultable via une interface visuelle Swagger (/docs.php). Cela facilite considérablement la génération automatique de code (clients) pour l’intégration dans des logiciels tiers. - Nouveaux points d’accès (Endpoints) :
GET /catalog.php: Liste le catalogue des satellites, avec une option pour inclure des statistiques sur les derniers rapports.GET /reports.php: Permet une recherche avancée des rapports avec des filtres (indicatif, locator ou grid square, période en heures, statut) et une limite précise de résultats.POST /reports.php: Gère la soumission des rapports (format JSON ou formulaire). Le système intègre désormais une correction intelligente : un second rapport envoyé par le même opérateur pour le même satellite dans un intervalle de 15 minutes UTC écrasera et corrigera automatiquement le premier.GET /health.php: Nouveau point de contrôle technique signalant la disponibilité de l’API et la fraîcheur des données (renvoie « degraded » si le dernier rapport a plus de 24 heures).
- Format de réponse standardisé : Les réponses adoptent une structure JSON unifiée intégrant des blocs
dataainsi que des enveloppes d’erreurs standardisées pour faciliter le débogage (error,code,message). - Compatibilité ascendante : Les anciens endpoints (
satellites.phpetsat_info.php) restent opérationnels afin de ne pas interrompre les applications existantes.
L’ensemble du code source, s’appuyant sur le langage PHP et renvoyant des données au format JSON, est disponible publiquement sous licence Apache 2.0 (les données elles-mêmes sont sous licence CC BY 4.0). Pour exploiter cette API, plusieurs règles strictes documentées doivent être respectées :
- Identification obligatoire (
User-Agent) : Toute requête doit comporter un en-tête personnalisé indiquant le nom de l’application, sa version et un contact. Les bibliothèques génériques (ex: curl, python-requests) risquent le blocage. - Limitation de fréquence : L’interrogation des serveurs (polling) ne doit pas se faire plus d’une fois toutes les 5 minutes.
Liens utiles
- Vue d’ensemble et directives d’utilisation : status.amsat.org/api/v1/overview.php
- Interface Swagger (Documentation) : status.amsat.org/api/v1/docs.php
- Dépôt officiel du code : GitHub AMSAT-NA/satellite-status
La communauté des développeurs est encouragée à faire migrer ses logiciels vers cette version 1.2. Pour toute question technique ou pour signaler un problème, il est recommandé d’utiliser l’onglet Issues du dépôt GitHub ou de rejoindre le canal dédié #open-source-dev sur le serveur Discord de l’AMSAT.
Voici un exemple d’instanciation par l’AMSAT-HB

















