6. Developer Notes

6.1. Overview

This page explains how to set up your own ODS API server that exposes mitigation requests (MR’s) for satellite operators.

The implementation details (programming language, database, hosting method) are up to you, but your server must conform to the JSON described in ODS Data JSON Fields so satellite operators can reliably query it.

6.2. Core Requirements

  • Your server should expose a publicly accessible endpoint

  • The endpoint must return future MR’s in JSON format matching the schema defined in ODS Data JSON Fields

  • Your server should update the data frequently enough that satellite operators can take action to avoid conflicts with telescope operations

  • You must coordinate your server and site details with satellite operators

6.3. Example Architectures

6.3.1. Example One - Python FastAPI + PostgreSQL

  • Store incoming MR’s in a PostgreSQL database

  • Provide an API endpoint that queries the database for future MR’s and returns this as JSON

6.3.2. Example Two - Static JSON File

  • Generate JSON files for future MR’s that match the schema in ODS Data JSON Fields

  • Serve this page from a simple web server (e.g. Apache, Nginx)

6.4. Best Practices

  • Use https for secure data transfer

  • Authenticate your endpoint using an API key or token-based auth. See Authentication example.