mirror of
https://github.com/DarkflameUniverse/DarkflameServer.git
synced 2026-10-02 10:53:44 +00:00
3dd4ebf853
Also sends key creation, rotation and revocation to security webhooks. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
60 lines
3.6 KiB
Django/Jinja
60 lines
3.6 KiB
Django/Jinja
{% extends "base.jinja2" %}
|
|
|
|
{% block title %}API - DarkflameServer{% endblock %}
|
|
|
|
{% block css %}
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/5.29.1/swagger-ui.min.css" integrity="sha512-QIJpSy6rqOKoEjIR+Pp7r5lTkNPJPJCRejWzG4jb12bCT1EeL/vcjZtk4NNKeEuVRXY+d34d/t9y1CHzZbgeJQ==" crossorigin="anonymous" referrerpolicy="no-referrer">
|
|
<style>
|
|
/* Swagger UI only comes in a light theme: give it a light panel of its own */
|
|
.api-explorer { --api-panel-bg: #fff; --api-panel-text: #3b4151; background: var(--api-panel-bg); color: var(--api-panel-text); border-radius: .5rem; padding: .5rem 1rem 1rem; }
|
|
.api-explorer .swagger-ui .info { margin: 1rem 0; }
|
|
.api-explorer .swagger-ui .scheme-container { box-shadow: none; padding: .5rem 0; }
|
|
</style>
|
|
{% endblock %}
|
|
|
|
{% block content %}
|
|
<h2 class="mb-1">API</h2>
|
|
<p class="text-body-secondary mb-3">Every endpoint your account may use. Open one and press <strong>Try it out</strong> to call it as yourself, right here.
|
|
The same description is at <a href="/api/openapi.json"><code>/api/openapi.json</code></a> (OpenAPI 3) for other tools.</p>
|
|
|
|
<div class="card mb-3">
|
|
<div class="card-header"><h5 class="mb-0">Signing in from scripts and bots</h5></div>
|
|
<div class="card-body small">
|
|
<p>Make an API key on <a href="/account">your account page</a> and send it with every request:</p>
|
|
<pre class="bg-body-tertiary p-2 rounded mb-2"><code>curl -H "Authorization: Bearer $KEY" http://localhost:2006/api/status</code></pre>
|
|
<p class="mb-2">A key can do what you picked for it (some of your permissions, or all of them), and never more than your account can do right
|
|
now: each request needs the permission for the page it matches, both on your account's <em>current</em> GM level and in the key.
|
|
Changing the account's level or banning it takes effect straight away. Keys can be read-only, limited to some addresses or paths, and
|
|
have a rate limit (answered with <code>429</code> and <code>Retry-After</code>; <code>X-RateLimit-Remaining</code> says what is left)
|
|
and a daily quota. Using the API at all needs the <code>api_access</code> permission.</p>
|
|
<p class="mb-2">Live updates: open a WebSocket to <code>/ws</code> (with the same <code>Authorization</code> header, or your sign-in cookie) and send
|
|
<code>{"event": "subscribe", "subscription": "chat_message"}</code> (or <code>table_changed</code>, <code>dashboard_update</code>, ...).</p>
|
|
<p class="mb-0 text-body-secondary">Tables take DataTables-style bodies: <code>{"start": 0, "length": 25, "search": "text"}</code>. Calls that act on
|
|
online players answer <code>{requestId}</code>; <code>GET /api/actions/{id}</code> gives the result.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="api-explorer" data-bs-theme="light" id="swagger"></div>
|
|
{% endblock %}
|
|
|
|
{% block scripts %}
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/5.29.1/swagger-ui-bundle.min.js" integrity="sha512-yfAKqi7F3JSDZA7V/XTql3caj2o8A81yg2EWIBykt2BJjLjNYnsd4CVAKvrFp/nYl9HQX7R06Z6e5KBn5aoj6g==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
|
|
<script>
|
|
SwaggerUIBundle({
|
|
url: '/api/openapi.json',
|
|
dom_id: '#swagger',
|
|
deepLinking: true, // links like /api_docs#/chat/get_api_chat
|
|
tryItOutEnabled: true,
|
|
docExpansion: 'none',
|
|
filter: true, // a box to search the endpoints
|
|
displayRequestDuration: true,
|
|
withCredentials: true,
|
|
// Calls go out as you (your sign-in cookie); the dashboard wants this header on cookie-signed requests (CSRF check)
|
|
requestInterceptor: function (request) {
|
|
request.headers['X-Requested-With'] = 'swagger';
|
|
return request;
|
|
}
|
|
});
|
|
</script>
|
|
{% endblock %}
|