Search
K

Getting started with SpaceDB

Welcome to the SpaceDB API Dev Portal — your home for exploring, registering for, and integrating with the SpaceDB family of APIs. This guide walks you from zero to your first successful API call.

What is SpaceDB?

SpaceDB exposes a catalog of space-domain data through a set of versioned HTTP APIs. Browse the available APIs on the APIs page and use this portal to register applications, manage credentials, and read integration guides.

Prerequisites

Before you begin, make sure you have:

  • A modern terminal with curl (or any HTTP client such as Postman or HTTPie)
  • A code editor for reviewing example snippets
  • An email address you can use to register a developer account

1. Create a developer account

  1. Click Sign up in the top navigation of the portal.
  2. Enter your work email and choose a password.
  3. Confirm your email address from the verification message we send you.
  4. Depending on portal settings, your account may be auto-approved or queued for review by an administrator.

Once your account is active, sign in and you'll land on your developer dashboard.

2. Register an application and get credentials

Applications are how SpaceDB issues credentials and tracks usage.

  1. From your dashboard, open My Apps and select New Application.
  2. Give the app a clear name (for example, orbital-tracker-dev) and a short description.
  3. Open the APIs page, pick an API you want to use, and click Register.
  4. Select the application you just created. When the registration is approved, your credentials will appear on the application detail page.

Keep credentials out of source control. Use environment variables or a secrets manager.

3. Make your first API call

With credentials in hand, you're ready to call an API. The exact endpoint and auth scheme depend on the API you registered for — check the API's reference page in the portal for details. A typical key-auth example looks like:

curl -i \
  -H "apikey: $SPACEDB_API_KEY" \
  https://api.example.com/v1/objects

A 200 OK response with a JSON body means you're in.

Where to go next

  • Browse the full catalog on the APIs page.
  • Read the Guides for deeper walkthroughs on documenting, publishing, and versioning APIs.
  • Use the built-in Try it console on any API reference page to experiment without writing code.

Need help? Reach out to your SpaceDB administrator or your account team.