Skip to main content

API Documentation

Overview​

All Power Source API documentation is hosted as an OpenAPI specification with hosted interactive documentation. The interactive docs allow you to test endpoints directly from your browser and explore the complete API surface.

Authentication​

API access tokens are managed through your user profile in the Power Source application. You can create and revoke tokens at any time for security purposes.

Creating an API Token​

  1. Log into the Power Source application at https://app.enertel.ai
  2. Click the user icon in the top-right navigation bar
  3. Navigate to your user profile
  4. Create a new API token
  5. Important: Copy and securely store your token immediately - it will only be displayed once

Your API token will look similar to this:

rtbp_9f8a3c2b1d4e5f60_kJ8vQ2mXw4nRzLc7TpYbF1gHdSaU5eIoP3qNM6tCVkA

Tokens do not expire by default. You can set an expiry date when creating one, and you can create a replacement token at any time. If a token has an expiry date, you will be notified before it arrives by email — sent to the address you sign in with — and in the application itself.

Using Your API Token​

All API requests require the access token in the authorization header:

HeaderValue
AuthorizationBearer <your_access_token>

Example API Call​

curl -H "Authorization: Bearer rtbp_9f8a3c2b1d4e5f60_kJ8vQ2mXw4nRzLc7..." \
     https://app.enertel.ai/api/me

Python Example​

import requests

token = "your_api_token_here"
headers = {"Authorization": f"Bearer {token}"}

response = requests.get("https://app.enertel.ai/api/me", headers=headers)
print(response.json())

Rate Limits and Best Practices​

  • Respect rate limits: Our APIs have reasonable rate limits to ensure fair usage
  • Use HTTPS: Always use secure connections (https://) for API calls
  • Handle errors gracefully: Check response status codes and implement proper error handling
  • Cache when appropriate: Cache responses when the data doesn't change frequently

Getting Help​