docs/SPACEX_API_INTEGRATION.md

Integración con la API de SpaceX

Este documento describe la integración de Orbix con la API pública de SpaceX para obtener información sobre lanzamientos, cohetes, cápsulas y misiones espaciales.

Descripción General

La API de SpaceX proporciona acceso a datos históricos y actuales sobre las operaciones de SpaceX. Esta integración permite a Orbix:

• Obtener información sobre lanzamientos pasados y futuros
• Acceder a detalles técnicos de cohetes y vehículos espaciales
• Consultar datos sobre cápsulas y su historial de misiones
• Complementar los datos orbitales de la NASA con información comercial espacial

Configuración

La integración requiere la siguiente variable de entorno:

SPACEX_API_URL=https://api.spacexdata.com/v3

Esta variable se puede configurar en un archivo .env en la raíz del proyecto o directamente en el entorno de ejecución.

Uso en el Código

Inicialización del Cliente

from orbix.spacex_api import SpaceXApi

spacex_api = SpaceXApi()

Obtener Lanzamientos

# Obtener todos los lanzamientos
launches = spacex_api.get_launches()
print(f"Total de lanzamientos: {len(launches['data'])}")

# Obtener lanzamientos con paginación
launches_page = spacex_api.get_launches(limit=10, offset=5)
print(f"Lanzamientos (página): {len(launches_page['data'])}")

Obtener Información de un Lanzamiento Específico

# Obtener información del lanzamiento con número de vuelo 65
launch = spacex_api.get_launch(flight_number=65)
print(f"Misión: {launch['mission_name']}")
print(f"Fecha: {launch['launch_date_utc']}")
print(f"Éxito: {launch['launch_success']}")

Obtener Información de Cohetes

# Obtener todos los cohetes
rockets = spacex_api.get_rockets()
print(f"Total de cohetes: {len(rockets['data'])}")

# Obtener información de un cohete específico
rocket = spacex_api.get_rocket(rocket_id="falcon9")
print(f"Nombre: {rocket['name']}")
print(f"Descripción: {rocket['description']}")

Obtener Información de Cápsulas

# Obtener todas las cápsulas
capsules = spacex_api.get_capsules()
print(f"Total de cápsulas: {len(capsules['data'])}")

# Obtener información de una cápsula específica
capsule = spacex_api.get_capsule(capsule_serial="C101")
print(f"Estado: {capsule['status']}")
print(f"Tipo: {capsule['type']}")
print(f"Misiones: {len(capsule['missions'])}")

Endpoints de la API

La integración expone los siguientes endpoints en la API de Orbix:

GET /spacex/launches

Devuelve información sobre lanzamientos de SpaceX.

Parámetros:

• limit (opcional): Número máximo de lanzamientos a obtener
• offset (opcional): Número de lanzamientos a saltar

Respuesta:

{
  "data": [
    {
      "flight_number": 65,
      "mission_name": "Telstar 19V",
      "launch_date_utc": "2018-07-22T05:50:00.000Z",
      "rocket": {
        "rocket_id": "falcon9",
        "rocket_name": "Falcon 9",
        "rocket_type": "FT"
      },
      "launch_site": {
        "site_name": "CCAFS SLC 40"
      },
      "launch_success": true
    },
    ...
  ]
}

GET /spacex/launches/{flight_number}

Obtiene información sobre un lanzamiento específico de SpaceX.

Respuesta:

{
  "flight_number": 65,
  "mission_name": "Telstar 19V",
  "launch_date_utc": "2018-07-22T05:50:00.000Z",
  "rocket": {
    "rocket_id": "falcon9",
    "rocket_name": "Falcon 9",
    "rocket_type": "FT"
  },
  "launch_site": {
    "site_name": "CCAFS SLC 40"
  },
  "launch_success": true,
  "details": "SSL-manufactured communications satellite intended to be placed in geostationary orbit at 63° West longitude, after an initial orbital raise and testing phase. The satellite is expected to have a useful life of about 15 years. Based on the SSL 1300 platform."
}

GET /spacex/rockets

Devuelve información sobre cohetes de SpaceX.

Respuesta:

{
  "data": [
    {
      "id": "falcon9",
      "name": "Falcon 9",
      "type": "rocket",
      "active": true,
      "stages": 2,
      "boosters": 0,
      "cost_per_launch": 50000000,
      "success_rate_pct": 97,
      "first_flight": "2010-06-04",
      "country": "United States",
      "company": "SpaceX",
      "height": {
        "meters": 70,
        "feet": 229.6
      },
      "diameter": {
        "meters": 3.7,
        "feet": 12
      },
      "mass": {
        "kg": 549054,
        "lb": 1207920
      },
      "payload_weights": [...],
      "first_stage": {...},
      "second_stage": {...},
      "engines": {...},
      "landing_legs": {...},
      "description": "Falcon 9 is a two-stage rocket designed and manufactured by SpaceX for the reliable and safe transport of satellites and the Dragon spacecraft into orbit."
    },
    ...
  ]
}

GET /spacex/rockets/{rocket_id}

Obtiene información sobre un cohete específico de SpaceX.

Respuesta:

{
  "id": "falcon9",
  "name": "Falcon 9",
  "type": "rocket",
  "active": true,
  "stages": 2,
  "boosters": 0,
  "cost_per_launch": 50000000,
  "success_rate_pct": 97,
  "first_flight": "2010-06-04",
  "country": "United States",
  "company": "SpaceX