{% extends "base.html" %}
{% block title %}API - RadiusForge{% endblock %}
{% block content %}
    {# Step API 3c (3 Oct 2026): made from apps/api/spec.py - tests compare it with the real API. #}
    <div class="rf-page-head">
        <div>
            <h1>API</h1>
            <p class="rf-lede">For a billing system or your own scripts. Address: <strong>{{ base }}</strong>.
                Keys are made on the <a href="{% url 'organization-settings' %}">Organization page</a>.
                <a href="{% url 'api-openapi' %}">Download openapi.json</a> for your tools.</p>
        </div>
    </div>

    <h2>Before you start</h2>
    <ul>
        {% for note in notes %}<li>{{ note }}</li>{% endfor %}
    </ul>
    <p>The examples keep the key in <code>$RFK</code>, so it never sits in your shell history. Type this, paste
        the key (nothing shows), and press Enter:</p>
    <pre class="rf-status-command">read -rs RFK</pre>

    <h2>Endpoints</h2>
    {% for e in endpoints %}
    <section class="rf-form-card">
        <h3><code>{{ e.method }} {{ e.path }}</code>{% if e.access == "write" %} <span class="rf-pill rf-pill-suspended">read-write key</span>{% endif %}</h3>
        <p>{{ e.summary }}</p>
        {% if e.query %}
        <p><strong>Query:</strong></p>
        <ul>{% for name, kind, text in e.query %}<li><code>{{ name }}</code> ({{ kind }}) - {{ text }}</li>{% endfor %}</ul>
        {% endif %}
        {% if e.body_fields %}
        <p><strong>Body (JSON):</strong></p>
        <ul>{% for name, kind, text, required in e.body_fields %}<li><code>{{ name }}</code> ({{ kind }}{% if required %}, required{% endif %}) - {{ text }}</li>{% endfor %}</ul>
        {% endif %}
        <p><strong>Answer:</strong> {{ e.answer }}</p>
        <pre class="rf-status-command">{{ e.curl }}</pre>
    </section>
    {% endfor %}

    <h2>When something is refused</h2>
    <p>Every refusal is JSON: <code>{"error": {"code": "...", "message": "..."}}</code>. The message is meant to be
        shown to a person; the code is for your program.</p>
    <table class="rf-cards">
        <thead><tr><th>Code</th><th>HTTP</th><th>Meaning</th></tr></thead>
        <tbody>
        {% for code, status, text in errors %}
            <tr><td data-label="Code" class="rf-primary"><code>{{ code }}</code></td><td data-label="HTTP">{{ status }}</td><td data-label="Meaning">{{ text }}</td></tr>
        {% endfor %}
        </tbody>
    </table>
{% endblock %}