> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionelectricity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to the iON Intelligent Electricity Developer Hub.

Here you will find everything you need to integrate your applications with iON smart hardware and fetch telemetry data.

***

## 🚀 Get Started

Choose your path to get up and running quickly:

<CardGroup cols={2}>
  <Card title="API Reference" href="/api-reference" icon="book">
    Explore our endpoints, view request schemas, and test the API directly.
  </Card>

  <Card title="API Authentication" href="/guides/api-authentication" icon="lock">
    Learn how to authenticate users and generate access tokens using OAuth 2.0.
  </Card>

  <Card title="Developer Portal" href="https://portal.ionelectricity.com" icon="key">
    Log in to generate your Client ID and Client Secret for SaaS integrations.
  </Card>

  <Card title="DIY / Python Quickstart" href="/guides/python-diy-quickstart" icon="python">
    Writing a personal script for a Raspberry Pi or Home Assistant? Start here.
  </Card>
</CardGroup>

***

## 🔐 Authentication Overview

iON uses standard OAuth 2.0 and JWTs for secure API access.

<Warning>
  **Security Notice:** All public endpoints on `api.ionelectricity.com` are strictly **Read-Only**.
</Warning>

If you are building an integration (like IFTTT) or a web application on behalf of other users, you must use the **OAuth 2.0 Authorization Code Flow**.

* To get your `Client ID` and `Client Secret`, please log in to the [iON Developer Portal](https://portal.ionelectricity.com).

***

## 🤖 Build with AI

Our documentation is fully optimized for AI coding assistants (like Cursor, GitHub Copilot, and Claude).

* **LLMs.txt:** Point your AI to `docs.ionelectricity.com/llms.txt` to instantly load our entire API context.
* **MCP Server:** Configure your AI's MCP settings to point to `https://docs.ionelectricity.com/mcp` for live API endpoint discovery.