Create a planet

Time to play god and create a new planet. What do you think? Ah, don't think too much. What could go wrong anyway?

Planets

POST

https://galaxy.scalar.com/planets

Try it

Server

Authorization (bearerAuth)

Body (application/json)

{
  "name": "Mars",
  "description": "The red planet",
  "type": "terrestrial",
  "habitabilityIndex": 0.68,
  "physicalProperties": {
    "mass": 0.107,
    "radius": 0.532,
    "gravity": 0.378,
    "temperature": {
      "min": 130,
      "max": 308,
      "average": 210,
      "temperatureMetric1": 0.1,
      "temperatureMetric2": 0.1
    },
    "measurement1": 0.1,
    "measurement2": 0.1
  },
  "atmosphere": [
    {
      "compound": "CO2",
      "percentage": 95.3,
      "atmosphericData1": "string",
      "atmosphericData2": "string"
    }
  ],
  "discoveredAt": "1610-01-07T00:00:00.000Z",
  "image": "https://cdn.scalar.com/photos/mars.jpg",
  "satellites": [
    {
      "name": "Phobos",
      "description": "Phobos is the larger and innermost of the two moons of Mars.",
      "diameter": 22.2,
      "type": "moon",
      "orbit": {
        "planet": {
          "name": "Mars",
          "description": "The red planet",
          "type": "terrestrial",
          "habitabilityIndex": 0.68,
          "physicalProperties": {
            "mass": 0.107,
            "radius": 0.532,
            "gravity": 0.378,
            "temperature": {
              "min": 130,
              "max": 308,
              "average": 210,
              "temperatureMetric1": 0.1,
              "temperatureMetric2": 0.1
            },
            "measurement1": 0.1,
            "measurement2": 0.1
          },
          "atmosphere": [
            {
              "compound": "CO2",
              "percentage": 95.3,
              "atmosphericData1": "string",
              "atmosphericData2": "string"
            }
          ],
          "discoveredAt": "1610-01-07T00:00:00.000Z",
          "image": "https://cdn.scalar.com/photos/mars.jpg",
          "satellites": [],
          "creator": {
            "name": "Marc"
          },
          "tags": [
            "solar-system",
            "rocky",
            "explored"
          ],
          "successCallbackUrl": "https://example.com/webhook",
          "failureCallbackUrl": "https://example.com/webhook"
        },
        "orbitalPeriod": 0.319,
        "distance": 9376
      }
    }
  ],
  "creator": {
    "name": "Marc"
  },
  "tags": [
    "solar-system",
    "rocky",
    "explored"
  ],
  "successCallbackUrl": "https://example.com/webhook",
  "failureCallbackUrl": "https://example.com/webhook"
}

Response

Authorization

bearerAuth (bearer)
JWT Bearer token authentication
basicAuth (basic)
Basic HTTP authentication
apiKeyQuery (query: api_key)
API key query parameter
apiKeyHeader (header: X-API-Key)
API key request header
apiKeyCookie (cookie: api_key)
API key browser cookie
oAuth2 (oauth2)
OAuth 2.0 authentication
openIdConnect (openIdConnect)
OpenID Connect Authentication

Request Body

Planet

Media Type

Planet

A planet in the Scalar Galaxy

id

integer <int64>Required

name

stringRequired

description?

string | null

type?

string

Enum:"terrestrial""gas_giant""ice_giant""dwarf""super_earth"

habitabilityIndex?

number <float>

A score from 0 to 1 indicating potential habitability

physicalProperties?

object

Map value

[key: string]?

number <float>

Additional physical measurements for the planet

mass?

number <float>

Mass in Earth masses (must be greater than 0)

radius?

number <float>

Radius in Earth radii (must be greater than 0)

gravity?

number <float>

Surface gravity in Earth g

temperature?

object

Map value

[key: string]?

number <float>

Additional temperature-related measurements in Kelvin

min?

number <float>

Minimum temperature in Kelvin

max?

number <float>

Maximum temperature in Kelvin

average?

number <float>

Average temperature in Kelvin

atmosphere?

array<object>

Atmospheric composition

object

Map value

[key: string]?

string

Additional atmospheric composition data

compound?

string

percentage?

number <float>

discoveredAt?

string <date-time>

image?

string | null

satellites?

array<Satellite>

creator?

User

tags?

array<string>

lastUpdated?

string <date-time>

successCallbackUrl?

string <uri>

URL which gets invoked upon a successful operation

failureCallbackUrl?

string <uri>

URL which gets invoked upon a failed operation

Responses

201

Created

Media Type

Planet

A planet in the Scalar Galaxy

id

integer <int64>Required

name

stringRequired

description?

string | null

type?

string

Enum:"terrestrial""gas_giant""ice_giant""dwarf""super_earth"

habitabilityIndex?

number <float>

A score from 0 to 1 indicating potential habitability

physicalProperties?

object

Map value

[key: string]?

number <float>

Additional physical measurements for the planet

mass?

number <float>

Mass in Earth masses (must be greater than 0)

radius?

number <float>

Radius in Earth radii (must be greater than 0)

gravity?

number <float>

Surface gravity in Earth g

temperature?

object

Map value

[key: string]?

number <float>

Additional temperature-related measurements in Kelvin

min?

number <float>

Minimum temperature in Kelvin

max?

number <float>

Maximum temperature in Kelvin

average?

number <float>

Average temperature in Kelvin

atmosphere?

array<object>

Atmospheric composition

object

Map value

[key: string]?

string

Additional atmospheric composition data

compound?

string

percentage?

number <float>

discoveredAt?

string <date-time>

image?

string | null

satellites?

array<Satellite>

creator?

User

tags?

array<string>

lastUpdated?

string <date-time>

successCallbackUrl?

string <uri>

URL which gets invoked upon a successful operation

failureCallbackUrl?

string <uri>

URL which gets invoked upon a failed operation

400

Bad Request

Media Type

BadRequestError

RFC 7807 (https://datatracker.ietf.org/doc/html/rfc7807)

type?

string

title?

string

status?

integer <int64>

detail?

string

403

Forbidden

Media Type

ForbiddenError

Error response for forbidden access (RFC 7807). Returned when the user does not have permission to access the requested resource.

type?

string

title?

string

status?

integer <int64>

detail?

string

Code Samples

curl -X POST 'https://galaxy.scalar.com/planets' \
  -H 'Authorization: Basic <base64-credentials>' \
  -H 'X-API-Key: <X-API-Key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Mars",
  "description": "The red planet",
  "type": "terrestrial",
  "habitabilityIndex": 0.68,
  "physicalProperties": {
    "mass": 0.107,
    "radius": 0.532,
    "gravity": 0.378,
    "temperature": {
      "min": 130,
      "max": 308,
      "average": 210,
      "temperatureMetric1": 0.1,
      "temperatureMetric2": 0.1
    },
    "measurement1": 0.1,
    "measurement2": 0.1
  },
  "atmosphere": [
    {
      "compound": "CO2",
      "percentage": 95.3,
      "atmosphericData1": "string",
      "atmosphericData2": "string"
    }
  ],
  "discoveredAt": "1610-01-07T00:00:00.000Z",
  "image": "https://cdn.scalar.com/photos/mars.jpg",
  "satellites": [
    {
      "name": "Phobos",
      "description": "Phobos is the larger and innermost of the two moons of Mars.",
      "diameter": 22.2,
      "type": "moon",
      "orbit": {
        "planet": {
          "name": "Mars",
          "description": "The red planet",
          "type": "terrestrial",
          "habitabilityIndex": 0.68,
          "physicalProperties": {
            "mass": 0.107,
            "radius": 0.532,
            "gravity": 0.378,
            "temperature": {
              "min": 130,
              "max": 308,
              "average": 210,
              "temperatureMetric1": 0.1,
              "temperatureMetric2": 0.1
            },
            "measurement1": 0.1,
            "measurement2": 0.1
          },
          "atmosphere": [
            {
              "compound": "CO2",
              "percentage": 95.3,
              "atmosphericData1": "string",
              "atmosphericData2": "string"
            }
          ],
          "discoveredAt": "1610-01-07T00:00:00.000Z",
          "image": "https://cdn.scalar.com/photos/mars.jpg",
          "satellites": [],
          "creator": {
            "name": "Marc"
          },
          "tags": [
            "solar-system",
            "rocky",
            "explored"
          ],
          "successCallbackUrl": "https://example.com/webhook",
          "failureCallbackUrl": "https://example.com/webhook"
        },
        "orbitalPeriod": 0.319,
        "distance": 9376
      }
    }
  ],
  "creator": {
    "name": "Marc"
  },
  "tags": [
    "solar-system",
    "rocky",
    "explored"
  ],
  "successCallbackUrl": "https://example.com/webhook",
  "failureCallbackUrl": "https://example.com/webhook"
}'

const response = await fetch("https://galaxy.scalar.com/planets", {
  method: "POST",
  headers: {
    "Authorization": "Basic <base64-credentials>",
    "X-API-Key": "<X-API-Key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "Mars",
    "description": "The red planet",
    "type": "terrestrial",
    "habitabilityIndex": 0.68,
    "physicalProperties": {
      "mass": 0.107,
      "radius": 0.532,
      "gravity": 0.378,
      "temperature": {
        "min": 130,
        "max": 308,
        "average": 210,
        "temperatureMetric1": 0.1,
        "temperatureMetric2": 0.1
      },
      "measurement1": 0.1,
      "measurement2": 0.1
    },
    "atmosphere": [
      {
        "compound": "CO2",
        "percentage": 95.3,
        "atmosphericData1": "string",
        "atmosphericData2": "string"
      }
    ],
    "discoveredAt": "1610-01-07T00:00:00.000Z",
    "image": "https://cdn.scalar.com/photos/mars.jpg",
    "satellites": [
      {
        "name": "Phobos",
        "description": "Phobos is the larger and innermost of the two moons of Mars.",
        "diameter": 22.2,
        "type": "moon",
        "orbit": {
          "planet": {
            "name": "Mars",
            "description": "The red planet",
            "type": "terrestrial",
            "habitabilityIndex": 0.68,
            "physicalProperties": {
              "mass": 0.107,
              "radius": 0.532,
              "gravity": 0.378,
              "temperature": {
                "min": 130,
                "max": 308,
                "average": 210,
                "temperatureMetric1": 0.1,
                "temperatureMetric2": 0.1
              },
              "measurement1": 0.1,
              "measurement2": 0.1
            },
            "atmosphere": [
              {
                "compound": "CO2",
                "percentage": 95.3,
                "atmosphericData1": "string",
                "atmosphericData2": "string"
              }
            ],
            "discoveredAt": "1610-01-07T00:00:00.000Z",
            "image": "https://cdn.scalar.com/photos/mars.jpg",
            "satellites": [],
            "creator": {
              "name": "Marc"
            },
            "tags": [
              "solar-system",
              "rocky",
              "explored"
            ],
            "successCallbackUrl": "https://example.com/webhook",
            "failureCallbackUrl": "https://example.com/webhook"
          },
          "orbitalPeriod": 0.319,
          "distance": 9376
        }
      }
    ],
    "creator": {
      "name": "Marc"
    },
    "tags": [
      "solar-system",
      "rocky",
      "explored"
    ],
    "successCallbackUrl": "https://example.com/webhook",
    "failureCallbackUrl": "https://example.com/webhook"
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.request(
    "POST",
    "https://galaxy.scalar.com/planets",
    headers={
        "Authorization": "Basic <base64-credentials>",
        "X-API-Key": "<X-API-Key>"
    },
    json={
        "name": "Mars",
        "description": "The red planet",
        "type": "terrestrial",
        "habitabilityIndex": 0.68,
        "physicalProperties": {
            "mass": 0.107,
            "radius": 0.532,
            "gravity": 0.378,
            "temperature": {
                "min": 130,
                "max": 308,
                "average": 210,
                "temperatureMetric1": 0.1,
                "temperatureMetric2": 0.1
            },
            "measurement1": 0.1,
            "measurement2": 0.1
        },
        "atmosphere": [
            {
                "compound": "CO2",
                "percentage": 95.3,
                "atmosphericData1": "string",
                "atmosphericData2": "string"
            }
        ],
        "discoveredAt": "1610-01-07T00:00:00.000Z",
        "image": "https://cdn.scalar.com/photos/mars.jpg",
        "satellites": [
            {
                "name": "Phobos",
                "description": "Phobos is the larger and innermost of the two moons of Mars.",
                "diameter": 22.2,
                "type": "moon",
                "orbit": {
                    "planet": {
                        "name": "Mars",
                        "description": "The red planet",
                        "type": "terrestrial",
                        "habitabilityIndex": 0.68,
                        "physicalProperties": {
                            "mass": 0.107,
                            "radius": 0.532,
                            "gravity": 0.378,
                            "temperature": {
                                "min": 130,
                                "max": 308,
                                "average": 210,
                                "temperatureMetric1": 0.1,
                                "temperatureMetric2": 0.1
                            },
                            "measurement1": 0.1,
                            "measurement2": 0.1
                        },
                        "atmosphere": [
                            {
                                "compound": "CO2",
                                "percentage": 95.3,
                                "atmosphericData1": "string",
                                "atmosphericData2": "string"
                            }
                        ],
                        "discoveredAt": "1610-01-07T00:00:00.000Z",
                        "image": "https://cdn.scalar.com/photos/mars.jpg",
                        "satellites": [],
                        "creator": {
                            "name": "Marc"
                        },
                        "tags": [
                            "solar-system",
                            "rocky",
                            "explored"
                        ],
                        "successCallbackUrl": "https://example.com/webhook",
                        "failureCallbackUrl": "https://example.com/webhook"
                    },
                    "orbitalPeriod": 0.319,
                    "distance": 9376
                }
            }
        ],
        "creator": {
            "name": "Marc"
        },
        "tags": [
            "solar-system",
            "rocky",
            "explored"
        ],
        "successCallbackUrl": "https://example.com/webhook",
        "failureCallbackUrl": "https://example.com/webhook"
    },
)
print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "name": "Mars",
  "description": "The red planet",
  "type": "terrestrial",
  "habitabilityIndex": 0.68,
  "physicalProperties": {
    "mass": 0.107,
    "radius": 0.532,
    "gravity": 0.378,
    "temperature": {
      "min": 130,
      "max": 308,
      "average": 210,
      "temperatureMetric1": 0.1,
      "temperatureMetric2": 0.1
    },
    "measurement1": 0.1,
    "measurement2": 0.1
  },
  "atmosphere": [
    {
      "compound": "CO2",
      "percentage": 95.3,
      "atmosphericData1": "string",
      "atmosphericData2": "string"
    }
  ],
  "discoveredAt": "1610-01-07T00:00:00.000Z",
  "image": "https://cdn.scalar.com/photos/mars.jpg",
  "satellites": [
    {
      "name": "Phobos",
      "description": "Phobos is the larger and innermost of the two moons of Mars.",
      "diameter": 22.2,
      "type": "moon",
      "orbit": {
        "planet": {
          "name": "Mars",
          "description": "The red planet",
          "type": "terrestrial",
          "habitabilityIndex": 0.68,
          "physicalProperties": {
            "mass": 0.107,
            "radius": 0.532,
            "gravity": 0.378,
            "temperature": {
              "min": 130,
              "max": 308,
              "average": 210,
              "temperatureMetric1": 0.1,
              "temperatureMetric2": 0.1
            },
            "measurement1": 0.1,
            "measurement2": 0.1
          },
          "atmosphere": [
            {
              "compound": "CO2",
              "percentage": 95.3,
              "atmosphericData1": "string",
              "atmosphericData2": "string"
            }
          ],
          "discoveredAt": "1610-01-07T00:00:00.000Z",
          "image": "https://cdn.scalar.com/photos/mars.jpg",
          "satellites": [],
          "creator": {
            "name": "Marc"
          },
          "tags": [
            "solar-system",
            "rocky",
            "explored"
          ],
          "successCallbackUrl": "https://example.com/webhook",
          "failureCallbackUrl": "https://example.com/webhook"
        },
        "orbitalPeriod": 0.319,
        "distance": 9376
      }
    }
  ],
  "creator": {
    "name": "Marc"
  },
  "tags": [
    "solar-system",
    "rocky",
    "explored"
  ],
  "successCallbackUrl": "https://example.com/webhook",
  "failureCallbackUrl": "https://example.com/webhook"
}`)
	req, err := http.NewRequest("POST", "https://galaxy.scalar.com/planets", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Basic <base64-credentials>")
	req.Header.Set("X-API-Key", "<X-API-Key>")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

Example Responses

{
  "id": 1,
  "name": "Mars",
  "description": "The red planet",
  "type": "terrestrial",
  "habitabilityIndex": 0.68,
  "physicalProperties": {
    "mass": 0.107,
    "radius": 0.532,
    "gravity": 0.378,
    "temperature": {
      "min": 130,
      "max": 308,
      "average": 210,
      "temperatureMetric1": 0.1,
      "temperatureMetric2": 0.1
    },
    "measurement1": 0.1,
    "measurement2": 0.1
  },
  "atmosphere": [
    {
      "compound": "CO2",
      "percentage": 95.3,
      "atmosphericData1": "string",
      "atmosphericData2": "string"
    }
  ],
  "discoveredAt": "1610-01-07T00:00:00.000Z",
  "image": "https://cdn.scalar.com/photos/mars.jpg",
  "satellites": [
    {
      "id": 1,
      "name": "Phobos",
      "description": "Phobos is the larger and innermost of the two moons of Mars.",
      "diameter": 22.2,
      "type": "moon",
      "orbit": {
        "planet": {
          "id": 1,
          "name": "Mars",
          "description": "The red planet",
          "type": "terrestrial",
          "habitabilityIndex": 0.68,
          "physicalProperties": {
            "mass": 0.107,
            "radius": 0.532,
            "gravity": 0.378,
            "temperature": {
              "min": 130,
              "max": 308,
              "average": 210,
              "temperatureMetric1": 0.1,
              "temperatureMetric2": 0.1
            },
            "measurement1": 0.1,
            "measurement2": 0.1
          },
          "atmosphere": [
            {
              "compound": "CO2",
              "percentage": 95.3,
              "atmosphericData1": "string",
              "atmosphericData2": "string"
            }
          ],
          "discoveredAt": "1610-01-07T00:00:00.000Z",
          "image": "https://cdn.scalar.com/photos/mars.jpg",
          "satellites": [],
          "creator": {
            "id": 1,
            "name": "Marc"
          },
          "tags": [
            "solar-system",
            "rocky",
            "explored"
          ],
          "lastUpdated": "2024-01-15T14:30:00.000Z",
          "successCallbackUrl": "https://example.com/webhook",
          "failureCallbackUrl": "https://example.com/webhook"
        },
        "orbitalPeriod": 0.319,
        "distance": 9376
      }
    }
  ],
  "creator": {
    "id": 1,
    "name": "Marc"
  },
  "tags": [
    "solar-system",
    "rocky",
    "explored"
  ],
  "lastUpdated": "2024-01-15T14:30:00.000Z",
  "successCallbackUrl": "https://example.com/webhook",
  "failureCallbackUrl": "https://example.com/webhook"
}

{
  "type": "https://example.com/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "The request was invalid."
}

{
  "type": "https://example.com/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "You are not authorized to access this resource."
}