SDK Getting Started Guide

Learn how to integrate the SPTORT.ORB Python SDK for real-time orbital calculations.

Step 1: Installation

Install the SDK using pip:

pip install sptort-orb-sdk
Make sure you have Python 3.8+ and pip configured for the latest release.

Step 2: Initialize the SDK

from sptort_orb import SDK

client = SDKClient(
    api_key="your_api_key",
    # Optional parameters
    endpoint="https://api.sptort-orb.com",
    environment="sandbox",
)
Tip: Use environment="sandbox" for testing.
  • Use your API key from the dashboard
  • Test environment is rate-limited to 100 requests/hour
  • Production SDK is fully featured with no rate limits

Step 3: Using the API

Basic Position Lookup

await client.get_position(
    satellite_id="Satellite-OS-123",
    timestamp="2025-08-28T12:34:56Z"
)
Returns latest orbital position in ECEF coordinates

Predictive Tracking

results = client.predicted_path(
    satellite="Satellite-OS-123",
    start_time="2025-08-28T00:00:00Z",
    end_time="2025-08-28T01:00:00Z",
    interval=180
)
Returns path data every 3 minutes (180s)

Debugging Tips

Common Errors

  • 401: Invalid API credentials format
  • 503: API maintenance in progress
Check API status dashboard for maintenance alerts.

Log Debug Info

# Enable debug
client = SDKClient(
    api_key="your_key",
    debug=True
)
Writes detailed logs to sptort-sdk.log

Need Help with SDK Integration?

Our aerospace engineers can help with mission-critical Python integrations and custom workflows.

Contact Support