Satélites
Esquema
enum Planet
{
Eris = "Eris",
Haumea = "Haumea",
Júpiter = "Júpiter",
Makemake = "Makemake",
Marte = "Marte",
Neptuno = "Neptuno",
Plutón = "Plutón",
Saturno = "Saturno",
Tierra = "Tierra",
Urano = "Urano",
}
// satellite
type Satellite =
{
id: number
name: string
planet: Planet
description: string
diameter: string
mass: string | null
webp: string | null
png: string | null
}
Esquema general
type SatellitesInfo =
{
info:
{
count: number
}
satellites: Satellite[]
}
Esquema de paginado
type SatellitesInfo =
{
info:
{
count: number
current: number
previous: string | null
next: string | null
pages: number
}
satellites: Satellite[]
}
Obtener todo
Puedes listar todos los satélites usando /satellites:
https://api-sistemasolar.nijui.com/api/satellites
GET https://api-sistemasolar.nijui.com/api/satellites
{
"info":
{
"count": 143
},
"satellites":
[
{
"id": 1,
"name": "Luna",
"planet": "Tierra",
"description": "La Luna es el único satélite natural de la Tierra. Se encuentra en relación síncrona con la Tierra, siempre mostrando la misma cara hacia el planeta. El hemisferio visible está marcado con oscuros mares lunares de origen volcánico entre las brillantes montañas antiguas y los destacados astroblemas.",
"diameter": "3474 km",
"mass": "7.3477 x 10^22 kg",
"webp": "https://storage.nijui.com/sistemasolar/planetas/tierra/satelites/luna.webp",
"png": "https://storage.nijui.com/sistemasolar/planetas/tierra/satelites/luna.png"
},
// ...
]
}
Filtrar por planeta
Parámetros
planet: id del planeta
Ejemplo: https://api-sistemasolar.nijui.com/api/satellites?planet=8
GET https://api-sistemasolar.nijui.com/api/satellites?planet=8
{
"info":
{
"count": 14
},
"satellites":
[
{
"id": 121,
"name": "Tritón",
"planet": "Neptuno",
"description": "Tritón se compone de una corteza de nitrógeno congelado sobre un manto de hielo, el cual se cree cubre un núcleo sólido de roca y metal. Tritón tiene una densidad media de 2.061 g/cm³ y está compuesto por aproximadamente un 15-35 % de agua helada.",
"diameter": "2707 km",
"mass": "2.14x10^22 kg",
"webp": "https://storage.nijui.com/sistemasolar/planetas/neptuno/satelites/triton.webp",
"png": "https://storage.nijui.com/sistemasolar/planetas/neptuno/satelites/triton.png"
},
// ...
]
}
Paginado
Parámetros
page(requerido): número de páginan_elements(opcional): número de elementos por página
https://api-sistemasolar.nijui.com/api/satellites?page=1&n_elements=3
GET https://api-sistemasolar.nijui.com/api/satellites?page=1&n_elements=3
{
"info":
{
"count": 143,
"current": 4,
"previous": "https://api-sistemasolar.nijui.com/api/satellites?page=3",
"next": "https://api-sistemasolar.nijui.com/api/satellites?page=5",
"pages": 72
},
"satellites":
[
{
"id": 7,
"name": "Tebe",
"planet": "Júpiter",
"description": "Tiene forma irregular y color rojizo. Los principales modelos geológicos indican que está formado por hielo de agua poroso con cantidades desconocidas de otras sustancias, al igual que Amaltea. Entre sus características superficiales se incluyen grandes cráteres y altas montañas.",
"diameter": "98,6 km",
"mass": "1,5 zettagramos",
"webp": "https://storage.nijui.com/sistemasolar/planetas/jupiter/satelites/tebe.webp",
"png": "https://storage.nijui.com/sistemasolar/planetas/jupiter/satelites/tebe.png"
},
// ...
]
}
Obtener un satélite
Puedes listar solo un satélite añadiendo el id como parámetro /2:
https://api-sistemasolar.nijui.com/api/satellites/2
GET https://api-sistemasolar.nijui.com/api/satellites/2
{
"id": 2,
"name": "Fobos",
"planet": "Marte",
"description": "Fobos es un pequeño satélite, de forma irregular, cuyo radio medio es de once kilómetros. Siempre presenta la misma cara a Marte, debido al anclaje por marea ejercido por el planeta. Orbita a unos 6000 kilómetros de la superficie marciana, lo que le convierte en el satélite más próximo a su planeta del sistema solar. Estas fuerzas de marea crean una desaceleración en Fobos, perdiendo este velocidad orbital, lo que ocasionará su colisión con Marte dentro de unos 50 a 100 millones de años, o bien su desintegración y formación de un anillo alrededor del planeta.",
"diameter": "22,2 km",
"mass": "1,08 x 10^16 kg",
"webp": "https://storage.nijui.com/sistemasolar/planetas/marte/satelites/fobos.webp",
"png": "https://storage.nijui.com/sistemasolar/planetas/marte/satelites/fobos.png"
}
Obtener múltiples satélites
Puedes listar múltiples satélites añadiendo un array de ids /2,3:
https://api-sistemasolar.nijui.com/api/satellites/2,3
GET https://api-sistemasolar.nijui.com/api/satellites/3,5
[
{
"id": 2,
"name": "Fobos",
"planet": "Marte",
"description": "Fobos es un pequeño satélite, de forma irregular, cuyo radio medio es de once kilómetros. Siempre presenta la misma cara a Marte, debido al anclaje por marea ejercido por el planeta. Orbita a unos 6000 kilómetros de la superficie marciana, lo que le convierte en el satélite más próximo a su planeta del sistema solar. Estas fuerzas de marea crean una desaceleración en Fobos, perdiendo este velocidad orbital, lo que ocasionará su colisión con Marte dentro de unos 50 a 100 millones de años, o bien su desintegración y formación de un anillo alrededor del planeta.",
"diameter": "22,2 km",
"mass": "1,08 x 10^16 kg",
"webp": "https://storage.nijui.com/sistemasolar/planetas/marte/satelites/fobos.webp",
"png": "https://storage.nijui.com/sistemasolar/planetas/marte/satelites/fobos.png"
},
{
"id": 3,
"name": "Deimos",
"planet": "Marte",
"description": "Deimos es el más pequeño y externo de los dos satélites de Marte. En rotación síncrona con el planeta, recorre una órbita casi circular, muy próxima al plano ecuatorial marciano, en 30,3 horas: un periodo ligeramente superior a la rotación del planeta rojo. Es de forma irregular. Tiene un diámetro medio de 12,4 km, una masa estimada de 1,4762x1015 kg y una densidad media de 1471 kg/m³. Su composición, supuesta similar a la de los asteroides de tipo D3 y los núcleos cometarios extintos.",
"diameter": "12,4 km",
"mass": "1,8 x 10^15 kg",
"webp": "https://storage.nijui.com/sistemasolar/planetas/marte/satelites/deimos.webp",
"png": "https://storage.nijui.com/sistemasolar/planetas/marte/satelites/deimos.png"
}
]