Flight information API

Resumen

Este punto final devuelve un resumen público de un solo vuelo, incluidos los enlaces a sus miniaturas de gráfico en todos los tamaños. Busque un vuelo por su id de vuelo en la nube o por el hash de firma que el verificador devuelve como flight_unique_id (el mismo valor que un piloto puede leer del propio archivo de registro).

Es una única consulta indexada y no devuelve información que identifique al usuario: ni cuenta, ni número de serie del dispositivo, ni dirección de carga, ni notas, imágenes o coordenadas de lanzamiento. La etiqueta de dispositivo y la etiqueta de competidor sí se incluyen, ya que identifican una entrada y no a una persona.

Punto final

Indique el id numérico o el hash de firma. Si se dan ambos, id tiene prioridad. Solo se devuelven vuelos visibles públicamente.

Parámetros

Respuesta

La API devuelve JSON. Los campos barométricos básicos están presentes en todos los vuelos. Los vuelos con IMU (Mercury, o Nano con revisión de hardware 4 y posterior) también incluyen un objeto imu con datos de aceleración, orientación, giro, estabilidad y doble despliegue. Los vuelos Mercury incluyen además un objeto mercury con datos adicionales de sensores y entorno (sonda de temperatura externa, batería, temperatura de la placa) que solo esa placa registra. Los vuelos solo barométricos omiten los bloques IMU y Mercury.

{
  "success": true,
  "flight": {
    "id": 1234,
    "url": "https://www.altimetercloud.com/es/flights/1234/",
    "csv_url": "https://www.altimetercloud.com/es/flightdata/4/1234.csv",
    "device": "nanov1",
    "firmware": "1.52",
    "revision": "4",
    "has_imu": 1,
    "tag": "MY-NANO",
    "competitor_tag": "C-07",
    "uploaddate": "10/06/26-14:22:01",
    "uploadstamp": 1781453721,
    "samples": 3210,
    "sps": 100,
    "apogee": 246.4,
    "apogee_time": 5210,
    "max_velocity": 98.3,
    "max_velocity_down": -12.4,
    "velocity_landing": 4.8,
    "landing_ms": 41800,
    "landing_m": 1.2,
    "flight_time": 41.8,
    "total_time": 44.2,
    "lockouts": 0,
    "not_real_flight": 0,
    "settings": {
      "sealevel": 1013.25,
      "samplerate": 100,
      "recordingstop": 1,
      "oversampling": 1,
      "iirfilter": 0,
      "pressurefilter": 1,
      "startuplock": 0,
      "usetemp": 1,
      "fixedtemp": 15,
      "launchdetect": 1,
      "sampleratio": 1,
      "maintainpower": 0,
      "maxsamples": 0,
      "recording_alt": 0,
      "units": 0,
      "units_velocity": 0,
      "units_acceleration": 0,
      "lockout_time": 0,
      "lockout_change": 0,
      "output_enable": 0,
      "orientation": 0,
      "launchprotection": 1
    },
    "imu": {
      "burnout": 1400,
      "ejection": 5600,
      "max_acceleration": 11.6,
      "acceleration": {
        "max_ascent": 11.6,
        "max_descent": 2.3,
        "max_burn": 11.6,
        "avg_ascent": 4.2,
        "avg_burn": 9.8
      },
      "velocity": {
        "burnout": 96.2,
        "descent": 5.1,
        "up_imu": 96.2,
        "down_imu": -11.8
      },
      "orientation": {
        "launch_pitch": 2,
        "launch_roll": 1,
        "launch_yaw": 0,
        "launch_tilt": 3,
        "max_tilt": 7
      },
      "spin": {
        "max": 540.5,
        "average": 120.2,
        "roll_rate": 33,
        "coning_rate": 4,
        "coning_power": 2
      },
      "stability": {
        "score": 92,
        "launch": 88,
        "coning": 95,
        "straight": 90,
        "confidence": 1,
        "thrust_straight": 97,
        "launch_tilt": 3
      },
      "dual_deploy": {
        "detected": 1,
        "drogue_velocity": 18.2,
        "main_velocity": 6.4,
        "main_altitude": 120.5,
        "main_time": 30200
      }
    },
    "thumbnails": {
      "meters_small": "https://www.altimetercloud.com/es/flightdata/4/1234.webp",
      "meters_large": "https://www.altimetercloud.com/es/flightdata/4/1234_l.webp",
      "feet_small":   "https://www.altimetercloud.com/es/flightdata/4/1234_ft.webp",
      "feet_large":   "https://www.altimetercloud.com/es/flightdata/4/1234_l_ft.webp",
      "miles_small":  "https://www.altimetercloud.com/es/flightdata/4/1234_mi.webp",
      "miles_large":  "https://www.altimetercloud.com/es/flightdata/4/1234_l_mi.webp",
      "km_small":     "https://www.altimetercloud.com/es/flightdata/4/1234_km.webp",
      "km_large":     "https://www.altimetercloud.com/es/flightdata/4/1234_l_km.webp"
    }
  }
}

Un vuelo solo barométrico (por ejemplo un Nano por debajo de la revisión 4) devuelve los mismos campos básicos con has_imu en 0 y sin bloque imu:

{
  "success": true,
  "flight": {
    "id": 980,
    "device": "nanov1",
    "firmware": "1.52",
    "revision": "2",
    "has_imu": 0,
    "apogee": 312.7,
    "apogee_time": 6120,
    "max_velocity": 104.5,
    "...": "core fields and settings, but no imu block"
  }
}

Si ningún vuelo público coincide con el id o el hash indicado:

{
  "success": false,
  "error": {
    "code": "404",
    "message": "No public flight found for that id or signature hash"
  }
}

Campos de la respuesta

Todas las medidas se devuelven en unidades base del SI: alturas en metros, velocidades en metros por segundo, aceleraciones en g, ángulos en grados, giro y tasas en grados por segundo, y tiempos en milisegundos salvo que se indique. La página del vuelo puede mostrarlas convertidas a las unidades que elija, pero la API siempre usa el SI.

Básicos (todos los vuelos)

imu (solo vuelos con IMU)

Presente solo cuando has_imu es 1. Ausente en los vuelos solo barométricos.

mercury (solo vuelos Mercury)

Presente solo en Mercury, que registra una capa adicional de sensores y entorno que el Nano no tiene. Se lee con el mejor esfuerzo desde el archivo de datos del vuelo, por lo que un firmware Mercury más antiguo puede devolver menos campos, y cualquier campo ausente simplemente se omite.

"mercury": {
  "mt1_temp_c": 16,
  "battery_start_pct": 98,
  "battery_end_pct": 95,
  "board_temp_start_c": 13.02,
  "board_temp_end_c": 12.25,
  "recovered": 0
}

Zona de pruebas de la API

Introduzca un id de vuelo público (o un hash de firma) y haga clic en Ejecutar para obtener su resumen.