Masa Coronal

Endpoint

Ruta: https://us-central1-totemfunctions.cloudfunctions.net/CMEAnalysis
Método: POST

Descripción

Este endpoint consulta los eventos de Eyección de Masa Coronal (CME) desde la integración con la NASA y proporciona un análisis detallado de los datos utilizando redes transformadoras. El análisis incluye una descripción de los eventos, implicaciones para la Tierra y recomendaciones para la vigilancia y preparación ante estos eventos.

Solicitud (Request)

Ejemplo de Cuerpo de Solicitud (JSON)

{
    "uid": "user123"
}

Descripción de Parámetros

uid (string): Identificador del usuario que está realizando la solicitud. Se utiliza para verificar la autorización del usuario.

Errores Comunes

400 Bad Request: Si falta el parámetro uid.
403 Forbidden: Si el uid no está autorizado.
500 Internal Server Error: En caso de errores internos del servidor durante el procesamiento de la solicitud.

Respuesta (Response)

Ejemplo de Cuerpo de Respuesta (JSON)

{
    "message": "Resultado del análisis de Eyección de Masa Coronal.",
    "cmeData": {
        "cmeEvents": [
            {
                "cmeId": "2024-07-05",
                "speed": 600,
                "halfAngle": 35,
                "catalog": "ALL",
                "timestamp": "2024-07-05T12:00:00Z"
            }
        ]
    },
    "interpretation": "El análisis de los datos de CME indica que se han registrado varios eventos significativos durante el período analizado. Estos eventos pueden tener implicaciones importantes para la tecnología espacial y terrestre, como interrupciones en las comunicaciones y problemas en los satélites. Se recomienda una vigilancia continua y preparación para mitigar los posibles impactos."
}

Descripción de Campos

message (string): Mensaje que indica el resultado del análisis de Eyección de Masa Coronal.
cmeData (object): Datos de los eventos de CME obtenidos de la API de la NASA, incluyendo detalles como:
- cmeEvents (array of objects): Lista de eventos de CME, con detalles como:
  - cmeId (string): Identificador del evento de CME.
  - speed (number): Velocidad del CME en km/s.
  - halfAngle (number): Ángulo de medio ancho del CME en grados.
  - catalog (string): Catálogo de eventos.
  - timestamp (string): Fecha y hora del evento en formato ISO 8601.
interpretation (string): Análisis detallado de los eventos de CME, incluyendo una descripción general, implicaciones para la Tierra y recomendaciones para la vigilancia y preparación.

Notas Adicionales

El campo interpretation proporciona un análisis en lenguaje natural de los eventos de CME, con implicaciones potenciales para la tecnología espacial y terrestre.
La respuesta está diseñada para proporcionar a los usuarios información clara y detallada sobre los eventos de CME y cómo estos pueden afectar a la tecnología y a las operaciones en la Tierra.

Last modified: 26 agosto 2024