Skip to main content

Planetas

Esquema​

type Planet = 
{
  id: number
  name: string
  planet_type: 
  {
    id: number
    name: 'Planetas' | 'Planetas Enanos'
  }
  description: string
  orbital_distance: string
  orbital_period: string
  radius: string
  volume: string
  diameter: string
  mass: string
  density: string
  gravity: string
  temperature: string
  atmosphere: string
  webp: string | null
  png: string | null
}

Esquema general​

type PlanetsInfo = 
{
  info: 
  {
    count: number
  }
  planets: Planet[]
}

Esquema de paginado​

type PlanetsInfo = 
{
  info: 
  {
    count: number
    current: number
    previous: string | null
    next: string | null
    pages: number
  }
  planets: Planet[]
}

Obtener todo​

Puedes listar todos los planetas usando /planetes: https://api-sistemasolar.nijui.com/api/planets

GET https://api-sistemasolar.nijui.com/api/planets
{
    "info": 
    {
        "count": 13
    },
    "planets": 
    [
        {
            "id": 1,
            "name": "Mercurio",
            "planet_type": 
            {
                "id": 1,
                "name": "Planetas"
            },
            "description": "Mercurio es el planeta del sistema solar más cercano al Sol y el más pequeño. Forma parte de los denominados planetas interiores y carece de satélites naturales al igual que Venus. Se conocía muy poco sobre su superficie hasta que fue enviada la sonda planetaria Mariner 10 y se hicieron observaciones con radar y radiotelescopios.",
            "orbital_distance": "57.91 millones de km",
            "orbital_period": "88 días",
            "radius": "2439,7 km",
            "volume": "6083x10^10 km³",
            "diameter": "4879,4 km",
            "mass": "3.3x10^23 kg",
            "density": "5.427 g/cm³",
            "gravity": "3.7 m/s²",
            "temperature": "Entre -180 °C y los 430 °C",
            "atmosphere": "Muy delgada, compuesta por trazas de gases como Oxígeno, Sodio, Hidrógeno, Helio y Potasio.",
            "webp": "https://storage.nijui.com/sistemasolar/planetas/mercurio/mercurio.webp",
            "png": "https://storage.nijui.com/sistemasolar/planetas/mercurio/mercurio.png"
        },
        // ...
    ]
}

Filtrar por tipo​

Parámetros

  • type : planetas (1) o planetas enanos(2)

Puedes filtrar usando /planets?type=1: https://api-sistemasolar.nijui.com/api/planets?type=2

GET https://api-sistemasolar.nijui.com/api/planets?type=2
{
    "info": 
    {
        "count": 13
    },
    "planets": 
    [
        {
            "id": 9,
            "name": "Plutón",
            "planet_type": 
            {
                "id": 2,
                "name": "Planetas Enanos"
            },
            "description": "Plutón posee una órbita excéntrica y altamente inclinada con respecto a la eclíptica, que recorre acercándose en su perihelio hasta el interior de la órbita de Neptuno. Su gran distancia al Sol y a la Tierra, unida a su reducido tamaño, impide que brille por encima de la magnitud 13,8 en sus mejores momentos, por lo cual solo puede ser apreciado con telescopios a partir de los 200 mm de abertura, fotográficamente o con cámara CCD.",
            "orbital_distance": "5906.4 millones de km",
            "orbital_period": "247.94 años",
            "radius": "1188.3 km",
            "volume": "71800x10^10 km³",
            "diameter": "2370 km",
            "mass": "1.309x10^22 kg",
            "density": "1.854 g/cm³",
            "gravity": "0.62 m/s²",
            "temperature": "Entre -233 °C y los -223 °C",
            "atmosphere": "Nitrógeno, Metano y Monóxido de Carbono.",
            "webp": "https://storage.nijui.com/sistemasolar/planetas/pluton/pluton.webp",
            "png": "https://storage.nijui.com/sistemasolar/planetas/pluton/pluton.png"
        },
        // ...
    ]
}

Paginado​

Parámetros

  • page (requerido): número de página
  • n_elements (opcional): número de elementos por página

Ejemplo: https://api-sistemasolar.nijui.com/api/planets?page=1&n_elements=3

GET https://api-sistemasolar.nijui.com/api/planets?page=1&n_elements=3
{
    "info": 
    {
        "count": 13,
        "current": 1,
        "previous": null,
        "next": "https://api-sistemasolar.nijui.com/api/planets?page=2",
        "pages": 5
    },
    "planets": 
    [
        {
            "id": 1,
            "name": "Mercurio",
            "planet_type": 
            {
                "id": 1,
                "name": "Planetas"
            },
            "description": "Mercurio es el planeta del sistema solar más cercano al Sol y el más pequeño. Forma parte de los denominados planetas interiores y carece de satélites naturales al igual que Venus. Se conocía muy poco sobre su superficie hasta que fue enviada la sonda planetaria Mariner 10 y se hicieron observaciones con radar y radiotelescopios.",
            "orbital_distance": "57.91 millones de km",
            "orbital_period": "88 días",
            "radius": "2439,7 km",
            "volume": "6083x10^10 km³",
            "diameter": "4879,4 km",
            "mass": "3.3x10^23 kg",
            "density": "5.427 g/cm³",
            "gravity": "3.7 m/s²",
            "temperature": "Entre -180 °C y los 430 °C",
            "atmosphere": "Muy delgada, compuesta por trazas de gases como Oxígeno, Sodio, Hidrógeno, Helio y Potasio.",
            "webp": "https://storage.nijui.com/sistemasolar/planetas/mercurio/mercurio.webp",
            "png": "https://storage.nijui.com/sistemasolar/planetas/mercurio/mercurio.png"
        },
        // ...
    ]
}

Obtener un planeta​

Puedes listar solo un planeta añadiendo el id como parámetro /planets/3: https://api-sistemasolar.nijui.com/api/planets/3

GET https://api-sistemasolar.nijui.com/api/planets/3
{
    "id": 3,
    "name": "Tierra",
    "planet_type": 
    {
        "id": 1,
        "name": "Planetas",
        "link": "https://api-sistemasolar.nijui.com/api/planet-types/1"
    },
    "description": "La Tierra se formó hace aproximadamente 4550 millones de años y la vida surgió unos mil millones de años después. Es actualmente el único cuerpo astronómico donde se conoce la existencia de vida. La atmósfera y otras condiciones abióticas han sido alteradas significativamente por la biosfera del planeta, favoreciendo la proliferación de organismos aerobios, así como la formación de una capa de ozono que junto con el campo magnético terrestre bloquean la radiación solar dañina, permitiendo así la vida en la Tierra",
    "orbital_distance": "149.6 millones de km",
    "orbital_period": "365.25 días",
    "radius": "6371 km",
    "volume": "1083.21x10^10 km³",
    "diameter": "12742 km",
    "mass": "5.97x10^24 kg",
    "density": "5.514 g/cm³",
    "gravity": "9.807 m/s²",
    "temperature": "Entre -89.2 °C y los 56.7 °C",
    "atmosphere": "Nitrógeno, Oxígeno, Argón y Dióxido de Carbono.",
    "webp": "https://storage.nijui.com/sistemasolar/planetas/tierra/tierra.webp",
    "png": "https://storage.nijui.com/sistemasolar/planetas/tierra/tierra.png"
}

Obtener múltiples planetas​

Puedes listar múltiples planetas añadiendo un array de ids /planets/3,4,5: https://api-sistemasolar.nijui.com/api/planets/3,5

GET https://api-sistemasolar.nijui.com/api/planets/3,5
[
    {
        "id": 3,
        "name": "Tierra",
        "planet_type": 
        {
            "id": 1,
            "name": "Planetas",
            "link": "https://api-sistemasolar.nijui.com/api/planet-types/1"
        },
        "description": "La Tierra se formó hace aproximadamente 4550 millones de años y la vida surgió unos mil millones de años después. Es actualmente el único cuerpo astronómico donde se conoce la existencia de vida. La atmósfera y otras condiciones abióticas han sido alteradas significativamente por la biosfera del planeta, favoreciendo la proliferación de organismos aerobios, así como la formación de una capa de ozono que junto con el campo magnético terrestre bloquean la radiación solar dañina, permitiendo así la vida en la Tierra",
        "orbital_distance": "149.6 millones de km",
        "orbital_period": "365.25 días",
        "radius": "6371 km",
        "volume": "1083.21x10^10 km³",
        "diameter": "12742 km",
        "mass": "5.97x10^24 kg",
        "density": "5.514 g/cm³",
        "gravity": "9.807 m/s²",
        "temperature": "Entre -89.2 °C y los 56.7 °C",
        "atmosphere": "Nitrógeno, Oxígeno, Argón y Dióxido de Carbono.",
        "webp": "https://storage.nijui.com/sistemasolar/planetas/tierra/tierra.webp",
        "png": "https://storage.nijui.com/sistemasolar/planetas/tierra/tierra.png"
    },
    {
        "id": 5,
        "name": "Júpiter",
        "planet_type": 
        {
            "id": 1,
            "name": "Planetas",
            "link": "https://api-sistemasolar.nijui.com/api/planet-types/1"
        },
        "description": "Júpiter es un cuerpo masivo gaseoso, formado principalmente por hidrógeno y helio, carente de una superficie interior definida. Entre los detalles atmosféricos es notable la Gran Mancha Roja (un enorme anticiclón situado en las latitudes tropicales del hemisferio sur), la estructura de nubes en bandas oscuras y zonas brillantes, y la dinámica atmosférica global determinada por intensos vientos zonales alternantes en latitud y con velocidades de hasta 140 m/s (504 km/h).",
        "orbital_distance": "778.6 millones de km",
        "orbital_period": "11.86 años",
        "radius": "69911 km",
        "volume": "1431280x10^10 km³",
        "diameter": "142984 km",
        "mass": "1.898x10^27 kg",
        "density": "1.326 g/cm³",
        "gravity": "24.79 m/s²",
        "temperature": "Entre -108 °C y los -13 °C",
        "atmosphere": "Hidrógeno, Helio y Metano.",
        "webp": "https://storage.nijui.com/sistemasolar/planetas/jupiter/jupiter.webp",
        "png": "https://storage.nijui.com/sistemasolar/planetas/jupiter/jupiter.png"
    }
]