Documentación de Campos de Respuesta

← Volver a Inicio

Introducción

Esta documentación proporciona detalles sobre los campos devueltos por los endpoints de la API Terra de Otter Dimension.
Para utilizar la API, es necesario proporcionar un token de autenticación.

Importante: Para acceder a los datos, es necesario incluir un token de autenticación en los encabezados de la solicitud HTTP.
Consulta la sección Token de API para más explicaciones acerca de su uso.

Datos de la Luna (/lua)

{
  "rise": "02:34",
  "set": "18:26",
  "transit": "10:24",
  "visualization": {
    "terminator_angle": "52.92°",
    "bright_edge": "West",
    "apparent_size": "0.54'",
    "magnitude": -8.44
  },
  "position": {
    "sky": {
      "azimut": "NNO",
      "altitude": "-19.24°"
    },
    "ecliptic": {
      "longitude": "65.601183°",
      "latitude": "4.959158°"
    },
    "distance": {
      "earth_center": "368036.74 km",
      "parallax": "0.9929°"
    }
  },
  "celestial_relations": {
    "sun_elongation": "52.92°",
    "sun_distance": "152004616.83 km"
  },
  "phase": {
    "name": "Waning Crescent",
    "waxing": false,
    "age_days": 10.4,
    "angle": "126.97°",
    "illumination": "19.9%",
    "next_phase": {
      "phase": "New Moon",
      "datetime": "2025-07-24T19:18:12+02:00",
      "julian_day": 2460881.220983
    }
  },
  "apsides": {
    "perigee": "2025-08-14T20:03:14+02:00",
    "is_spring_tide": false,
    "apogee": "2025-08-01T22:35:24+02:00",
    "distance": {
      "perigee_km": 369252.8,
      "apogee_km": 404201
    }
  },
  "closest_perigee": {
    "date": "2025-11-05T23:33:56+01:00",
    "distance_km": 356827.66
  }
}
rise
string

Hora de salida de la Luna en formato HH:MM en huso horario de Madrid.

set
string

Hora de puesta de la Luna en formato HH:MM en huso horario de Madrid.

transit
string

Hora de tránsito de la Luna en formato HH:MM en huso horario de Madrid.

visualization
object
terminator_angle
string

Ángulo del terminador lunar en grados.

bright_edge
string

Dirección del borde iluminado (Este/Oeste).

apparent_size
string

Tamaño aparente de la Luna en minutos de arco.

magnitude
number

Magnitud aparente de la Luna.

position
object
sky
object
azimut
string

Azimut de la Luna en dirección cardinal.

altitude
string

Altitud de la Luna en grados.

ecliptic
object
longitude
string

Longitud eclíptica de la Luna en grados.

latitude
string

Latitud eclíptica de la Luna en grados.

distance
object
earth_center
string

Distancia desde el centro de la Tierra en kilómetros

parallax
string (°)

Paralaje de la Luna en grados

celestial_relations
object
sun_elongation
string (°)

Ángulo de elongación respecto al Sol en grados

sun_distance
string (km)

Distancia desde el Sol en kilómetros

phase
object
name
string

Nombre de la fase lunar (por ejemplo, "Waning Crescent")

waxing
boolean

Indica si la Luna está creciente (true) o menguante (false)

age_days
number

Edad de la Luna en días

angle
string (°)

Ángulo de fase lunar en grados

illumination
string (%)

Porcentaje de iluminación lunar

next_phase
object
phase
string

Nombre de la próxima fase lunar

datetime
string (ISO 8601)

Fecha y hora de la próxima fase lunar

julian_day
number

Día juliano de la próxima fase lunar

apsides
object
perigee
string (ISO 8601)

Fecha y hora del próximo perigeo lunar

is_spring_tide
boolean

Indica si hay marea vivas en el perigeo

apogee
string (ISO 8601)

Fecha y hora del próximo apogeo lunar

distance
object
perigee_km
number (km)

Distancia al perigeo lunar en kilómetros

apogee_km
number (km)

Distancia al apogeo lunar en kilómetros

closest_perigee
object
date
string (ISO 8601)

Fecha y hora del perigeo lunar más cercano en el año

distance_km
number (km)

Distancia al perigeo lunar más cercano en kilómetros

Datos del Sol disponibles en /sol

{"rise":"07:17","set":"22:06","transit":"14:42"}
rise
string (HH:MM)

Hora de salida del Sol en formato HH:MM

set
string (HH:MM)

Hora de puesta del Sol en formato HH:MM

transit
string (HH:MM)

Hora de tránsito del Sol en formato HH:MM

Datos de las Mareas disponibles en /mareas

{"fecha":"20-07-2025","tides":[{"hora":"00:02","altura":2.977,"tipo":"pleamar"},{"hora":"06:23","altura":1.131,"tipo":"bajamar"},{"hora":"12:44","altura":2.941,"tipo":"pleamar"},{"hora":"19:05","altura":1.137,"tipo":"bajamar"}]}
fecha
string (DD-MM-YYYY)

Fecha de los datos de marea en formato DD-MM-YYYY

tides
array

Lista de eventos de marea para la fecha consultada

[array item]
object
hora
string (HH:MM)

Hora del evento de marea en formato HH:MM

altura
number (m)

Altura de la marea en metros

tipo
string

Tipo de marea (pleamar/bajamar)

Punto de Referencia

Actualmente, la API está diseñada usando como punto de referencia la playe de Boa Grande, ría de Muros y Noia.

Token de API

Para utilizar esta API es necesario proporcionar un token válido en cada solicitud.
Para pruebas, se puede usar el token: "pruebas" (limitado a una consulta por minuto).

Ejemplo de uso: 

Authorization: Bearer <tu_token>