{% extends 'base.html' %}

{% block title %}Admin API Documentation{% endblock %}

{% block content %}
<div class="container mt-4">
    <h1>Admin API Documentation</h1>
    <p class="lead">Administrative API endpoints for system management.</p>

    <div class="alert alert-warning">
        <strong>Authentication:</strong> All endpoints require admin authentication via login session or admin API token (Bearer token in Authorization header).
    </div>

    <h2>Endpoints</h2>

    <div class="endpoint" id="browse">
        <h3>GET /admin/api/browse</h3>
        <p>Browse files in the configured server directory.</p>
        <h4>Parameters:</h4>
        <ul>
            <li><code>path</code> (string, optional): Directory path to browse (default: root)</li>
        </ul>
        <h4>Curl Example:</h4>
        <pre><code>curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" "{{ request.host_url }}admin/api/browse?path=/some/path"</code></pre>
        <h4>Response:</h4>
        <pre><code>{
  "current_path": "/some/path",
  "items": [
    {"name": "file.txt", "path": "/some/path/file.txt", "is_dir": false, "size": 1024}
  ]
}</code></pre>
    </div>

    <div class="endpoint" id="train">
        <h3>POST /admin/api/train</h3>
        <p>Start model training. Costs 100 tokens (free for admins).</p>
        <h4>Parameters:</h4>
        <ul>
            <li><code>output_model</code> (string, optional): Output model name (default: "MyCustomModel")</li>
            <li><code>description</code> (string, optional): Model description</li>
            <li><code>train_path</code> (string, required): Path to training data directory</li>
        </ul>
        <h4>Curl Example:</h4>
        <pre><code>curl -X POST -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" -H "Content-Type: application/json" -d '{
  "output_model": "MyModel",
  "description": "Custom trained model",
  "train_path": "/path/to/training/data"
}' {{ request.host_url }}admin/api/train</code></pre>
        <h4>Response:</h4>
        <pre><code>{
  "message": "Training completed",
  "tokens_used": 100,
  "remaining_tokens": 900
}</code></pre>
    </div>

    <div class="endpoint" id="users">
        <h3>GET /admin/api/users</h3>
        <p>List all users in the system.</p>
        <h4>Curl Example:</h4>
        <pre><code>curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" {{ request.host_url }}admin/api/users</code></pre>
        <h4>Response:</h4>
        <pre><code>{
  "users": [
    {"id": 1, "username": "user1", "email": "user1@example.com", "role": "user", "tokens": 100, "active": true, "created_at": "2024-01-01T00:00:00Z"}
  ]
}</code></pre>
    </div>

    <div class="endpoint" id="cluster_tokens">
        <h3>GET /admin/api/cluster_tokens</h3>
        <p>List all cluster tokens.</p>
        <h4>Curl Example:</h4>
        <pre><code>curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" {{ request.host_url }}admin/api/cluster_tokens</code></pre>
        <h4>Response:</h4>
        <pre><code>{
  "tokens": [
    {"id": 1, "name": "Worker Token", "token": "abc123...", "active": true, "created_at": "2024-01-01T00:00:00Z"}
  ]
}</code></pre>
    </div>

</div>
{% endblock %}