Developer API

Le API di Spaces sono progettate per essere semplici e RESTful. Tutte le risposte sono restituite in formato JSON standard. L'accesso è pubblico e non richiede autenticazione per le chiamate in sola lettura.

Base URL: Tutte le richieste devono essere effettuate verso:
https://www.spacesbetweenus.it/api/

Launches API

GET /launches?mode=next

Ottieni i dettagli del prossimo lancio confermato nel calendario.

JSON Response { "id": 42, "name": "Starship IFT-4", "net": "2024-06-05 13:00:00", "rocket": { "name": "Starship", "company": "SpaceX" } }
GET /launches?mode=upcoming

Restituisce una lista cronologica dei lanci futuri.

Param Tipo Descrizione
limit INT Opzionale. Numero max di risultati (Max: 100, Default: 10).
mode STRING Usa past per ottenere l'archivio storico dei lanci avvenuti.

Missions API

Le missioni raggruppano più lanci ed eventi sotto un unico programma (es. Artemis).

GET /missions?mode=active

Restituisce le missioni attualmente in corso (es. spedizioni ISS).

GET /missions?mode=id&id={id}

Restituisce l'oggetto completo di una missione, inclusi gli array nidificati di Lanci ed Eventi collegati.

Param Tipo Descrizione
id INT Richiesto. L'ID univoco della missione.
JSON Response Example { "id": 1, "name": "Artemis I", "timeline": { "status": "Completed" }, "launches": [ ... ], "events": [ ... ] }

Vehicles API

Dati tecnici sui vettori di lancio, statistiche di affidabilità e inventario dei booster.

GET /vehicles?mode=list

Restituisce l'elenco di tutti i razzi disponibili nel database con le informazioni principali.

Param Tipo Descrizione
limit INT Opzionale. Imposta -1 per ottenere l'elenco completo senza limiti.
GET /vehicles?mode=id&id={id}

Fornisce dettagli tecnici, statistiche calcolate in tempo reale (percentuale successi) e l'inventario della flotta (stadi/booster) associata al veicolo.

Param Tipo Descrizione
id INT Richiesto. L'ID del razzo (es. Falcon 9, Ariane 5).
JSON Response Example { "id": 1, "name": "Falcon 9", "manufacturer": { "name": "SpaceX", "country": "USA" }, "statistics": { "total_launches": 150, "reliability": "99.3%" }, "fleet": [ { "stageName": "B1058", "status": "attivo" } ] }

Reuse API

Monitoraggio della flotta di stadi riutilizzabili (booster).

GET /reuse?mode=list

Restituisce l'inventario completo degli stadi, ordinati per numero di voli effettuati.

JSON Response Example [ { "serial": "B1058", "vehicle": "Falcon 9", "status": "attivo", "flights": 19 }, ... ]
GET /reuse?mode=id&id={id}

Fornisce la storia operativa completa di uno specifico stadio, inclusi i risultati di atterraggio per ogni missione.

Param Tipo Descrizione
id INT Richiesto. L'ID dello stadio.
JSON Response Example { "serial": "B1069", "stats": { "flights_count": 11, "successful_landings": 11 }, "flight_history": [ { "launchName": "Starlink v2", "landingStatus": "riuscito" } ] }

Agencies API

Profili delle agenzie spaziali e compagnie private (SpaceX, NASA, ESA).

GET /agencies?mode=list

Lista di tutte le organizzazioni registrate.

GET /agencies?mode=id&id={id}

Restituisce profilo, flotta di razzi e statistiche aggregate di tutti i lanci effettuati nella storia dell'azienda.

JSON Response Example { "name": "SpaceX", "country": { "code": "USA" }, "stats": { "total_launches": 300, "success_rate": "99.1%" }, "rockets": [ ... ] }

Locations API

Accesso geografico e operativo ai porti spaziali (Spaceports). Include sia rampe di lancio che zone di atterraggio.

GET /locations?mode=list

Restituisce una lista unificata di tutti i punti di interesse (Launch Pads e Landing Pads). Utile per popolare mappe o liste di selezione.

JSON Response Example [ { "id": 39, "type": "launch_pad", "name": "Launch Complex 39A", "location": "Kennedy Space Center, FL" }, { "id": 1, "type": "landing_pad", "name": "LZ-1", "location": "Cape Canaveral, FL" } ]
GET /locations?mode=launch_pad&id={id}

Dettagli di una rampa di lancio, incluso il prossimo volo programmato da quella posizione.

GET /locations?mode=landing_pad&id={id}

Dettagli di una zona di atterraggio e statistiche sui recuperi effettuati.

Global Search API

Permette di cercare contemporaneamente tra lanci, missioni, veicoli e agenzie con un'unica richiesta.

GET /search?q={query}

Motore di ricerca unificato. Restituisce una lista eterogenea di risultati, utile per barre di ricerca e autocompletamento.

Param Tipo Descrizione
q STRING Richiesto. La stringa da cercare (minimo 2 caratteri). Es: "Falcon", "Artemis".
limit INT Opzionale. Numero massimo risultati (Default: 20).
JSON Response Example (?q=star) [ { "id": 15, "name": "Starlink 4-1", "type": "launch", "api_url": ".../api/launches.php?mode=id&id=15", "date": "2023-01-15 10:00:00" }, { "id": 2, "name": "Starship", "type": "rocket", "api_url": ".../api/vehicles.php?mode=id&id=2" } ]

Statistics API

Endpoint di aggregazione dati ottimizzati per la generazione di grafici e dashboard.

GET /stats?mode={tipo}

Restituisce dati aggregati pronti per il rendering grafico.

Param Tipo Descrizione
mode STRING Valori accettati:
launches_per_year (Trend storico)
success_rate (Affidabilità globale)
top_agencies (Classifica aziende)
by_country (Geopolitica spaziale)
JSON Response Example { "type": "bar_chart", "title": "Lanci orbitali per anno", "data": [ { "label": 2020, "value": 114 }, { "label": 2021, "value": 135 }, { "label": 2022, "value": 180 } ] }