🔐 Authentication

Skycaster uses API key-based authentication to secure requests. Every request to our endpoints must include your unique API key.

🧾 How It Works

After signing up and creating an account on the Skycaster Dashboard , you’ll receive a personal API key.

Include this key in every API call either as a query parameter or as a header.

🌐 Base URL

https://skycaster.tv/api/public/v1/

All API endpoints are relative to this base URL.

✅ Using API Key

🔗 Query Parameter

Append your API key to the URL like so:

curl -X GET 'https://skycaster.tv/api/public/v1/weather?apiKey=YOUR_API_KEY_HERE'

🧾 HTTP Header

Alternatively, include the API key in the Authorization header:

curl -X GET 'https://skycaster.tv/api/public/v1/weather' \
-H 'Authorization: Bearer YOUR_API_KEY_HERE'

Tip: The header method is more secure and is recommended for production usage.

🚫 Invalid or Missing API Key

If your API key is invalid or not included, the API will return an error response:

{
"error": "Unauthorized",
"message": "API key is missing or invalid."
}

🛡️ Security Best Practices

• Keep your API key secret — never expose it in frontend code or public repositories.
• Make requests from a secure, server-side environment whenever possible.
• Rotate your key regularly and revoke any compromised credentials.
• Store the key securely using environment variables or secrets managers.

📞 Need Assistance?

If you have questions or need support:

• Contact Support: Reach out via our Support Page .
• Email Us: Send inquiries to support@skycaster.tv.