api.md

Scalar Galaxy TypeScript API

Complete reference of every operation, grouped by resource. See the README for usage and configuration.

Contents

• Planets
  • Get all planets
  • Create a planet
  • Get a planet
  • Update a planet
  • Delete a planet
  • Upload an image to a planet
• CelestialBodies
  • Create a celestial body
• Authentication
  • Create a user
  • Get a token
  • Get authenticated user

Setup

import Galaxy from '@scalar/galaxy-node';

const client = new Galaxy({
  bearerAuth: process.env['BEARER_AUTH'], // defaults to the BEARER_AUTH env var
  environment: 'production',
});

Planets

Everything about planets

Get all planets

It's easy to say you know them all, but do you really? Retrieve all the planets and check whether you missed one.

Direction	Type
Request	PlanetListAllDataParams
Response	PlanetListAllDataResponse

const listAllData = await client.planets.listAllData({
  limit: 10,
  offset: 0,
});

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?

Direction	Type
Request	PlanetCreateParams
Response	Planet

const planet = await client.planets.create({
  name: 'Mars',
});

Get a planet

You'll better learn a little bit more about the planets. It might come in handy once space travel is available for everyone.

Direction	Type
Response	Planet

const planet = await client.planets.retrieve(1);

Update a planet

Sometimes you make mistakes, that's fine. No worries, you can update all planets.

Direction	Type
Request	PlanetUpdateParams
Response	Planet

const planet = await client.planets.update(1, {
  name: 'Mars',
});

Delete a planet

This endpoint was used to delete planets. Unfortunately, that caused a lot of trouble for planets with life. So, this endpoint is now deprecated and should not be used anymore.

await client.planets.delete(1);

Upload an image to a planet

Got a crazy good photo of a planet? Share it with the world!

Direction	Type
Request	PlanetUploadImageParams
Response	PlanetUploadImageResponse

const uploadImage = await client.planets.uploadImage(1);

CelestialBodies

Celestial bodies are the planets and satellites in the Scalar Galaxy.

Create a celestial body

Stars, moons, comets, the occasional rogue asteroid — if it glows or drifts through the void, you can add it here.

Direction	Type
Request	CelestialBodyCreateParams
Response	CelestialBody

const celestialBody = await client.celestialBodies.create({
  name: 'Mars',
});

Authentication

Some endpoints are public, but some require authentication. We provide all the required endpoints to create an account and authorize yourself.

Create a user

Time to create a user account, eh?

Direction	Type
Request	AuthenticationCreateUserParams
Response	User

const user = await client.authentication.createUser({
  name: 'Marc',
  email: 'marc@scalar.com',
  password: 'i-love-scalar',
});

Get a token

Yeah, this is the boring security stuff. Just get your super secret token and move on.

Direction	Type
Request	AuthenticationCreateTokenParams
Response	AuthenticationCreateTokenResponse

const createToken = await client.authentication.createToken({
  email: 'marc@scalar.com',
  password: 'i-love-scalar',
});

Get authenticated user

Find yourself they say. That's what you can do here.

Direction	Type
Response	User

const user = await client.authentication.listMe();