Authentication

Overview

The Urban Sky SDK uses API tokens for authentication. These tokens provide secure access to your organization's balloon telemetry data.

Getting an API Token

To obtain an API token for your organization:

1. Contact Urban Sky Support at support@atmosys.com
2. Provide your organization details and intended use case
3. Receive your API token via secure email

Important Security Notes

• API tokens are sensitive and should be kept secure
• Use tokens only on server-side applications, never in client-side code
• Never commit tokens to version control systems
• Store tokens as environment variables or in secure configuration

Using Your API Token

JavaScript

// Load the SDK
const response = await fetch('https://sdk.atmosys.com/runtime/js/current/loader.js')
eval(await response.text())

// Initialize and connect with your token
const sdk = await UrbanSkySDK.init({
  apiToken: 'your-api-token-here',
})

Python

The Python SDK requires requests to load the SDK, and centrifuge-python must be available in your environment:

pip install requests centrifuge-python

import asyncio

import requests

# Load the SDK
exec(requests.get('https://sdk.atmosys.com/runtime/py/current/loader.py').text)

# Initialize with your token
async def main():
    sdk = await UrbanSkySDK.init({
        'apiToken': 'your-api-token-here'
    })

asyncio.run(main())

Environment Variables (Recommended)

Store your token as an environment variable for better security:

// JavaScript
const sdk = await UrbanSkySDK.init({
  apiToken: process.env.URBAN_SKY_API_TOKEN,
})

# Python
import asyncio
import os

import requests

# Load the SDK
exec(requests.get('https://sdk.atmosys.com/runtime/py/current/loader.py').text)

async def main():
    sdk = await UrbanSkySDK.init({
        'apiToken': os.environ['URBAN_SKY_API_TOKEN']
    })

asyncio.run(main())

Troubleshooting

Common Authentication Errors

"Invalid API token"

• Verify the token is correctly copied without extra spaces
• Ensure you're using the token provided by Urban Sky support
• Contact support if the issue persists

"Authentication failed"

• Check that your token has not been revoked
• Verify you're connecting to the correct API endpoint
• Contact support to verify your token status

Getting Help

If you experience authentication issues:

1. Double-check your token is correctly configured
2. Review the Error Handling Guide for detailed error codes
3. Contact Urban Sky support at support@atmosys.com with:
   • Your organization name
   • The error message you're receiving
   • The time the error occurred