53 lines
5.1 KiB
Python
53 lines
5.1 KiB
Python
|
# retoor <retoor@molodetz.nl>
|
||
|
|
from molodetz.docs_api.registry import endpoint, field
|
||
|
|
|
||
|
|
GROUP = {
|
||
|
|
"slug": "beheer",
|
||
|
|
"title": "Beheer",
|
||
|
|
"description": "Alleen voor beheerders. Berichten schrijven en publiceren, aanmeldingen, services, prullenbak, instellingen.",
|
||
|
|
"endpoints": [
|
||
|
|
endpoint("GET", "/admin", "Overzicht", auth="admin", sample={"post_count": 5, "open_joins": 0, "user_count": 1, "deleted_count": 0}),
|
||
|
|
endpoint("GET", "/admin/posts", "Berichten", auth="admin", sample={"posts": []}),
|
||
|
|
endpoint("GET", "/admin/posts/new", "Nieuw bericht", auth="admin", sample={}),
|
||
|
|
endpoint(
|
||
|
|
"POST",
|
||
|
|
"/admin/posts",
|
||
|
|
"Bericht aanmaken",
|
||
|
|
"Markdown-bericht aanmaken; status draft of published.",
|
||
|
|
auth="admin",
|
||
|
|
fields=[
|
||
|
|
field("title", required=True, example="Een titel"),
|
||
|
|
field("body", required=True, example="Tekst in **markdown**."),
|
||
|
|
field("topic", enum=["rol", "standaard"], example="rol"),
|
||
|
|
field("status", enum=["draft", "published"], example="draft"),
|
||
|
|
field("is_placeholder", type="boolean"),
|
||
|
|
],
|
||
|
|
sample={"ok": True, "redirect": "/admin/posts", "data": {"uid": "..."}},
|
||
|
|
probe_body={"title": "x"},
|
||
|
|
),
|
||
|
|
endpoint("GET", "/admin/posts/{uid}/edit", "Bericht bewerken", auth="admin", fields=[field("uid", required=True, location="path")], probe_path="/admin/posts/onbekend/edit"),
|
||
|
|
endpoint("POST", "/admin/posts/{uid}", "Bericht opslaan", auth="admin", fields=[field("uid", required=True, location="path")], probe_path="/admin/posts/onbekend", probe_body={"title": "x"}),
|
||
|
|
endpoint("POST", "/admin/posts/{uid}/publish", "Publiceren", auth="admin", fields=[field("uid", required=True, location="path")], probe_path="/admin/posts/onbekend/publish"),
|
||
|
|
endpoint("POST", "/admin/posts/{uid}/delete", "Bericht verwijderen", "Zachte verwijdering; herstel via prullenbak.", auth="admin", destructive=True, fields=[field("uid", required=True, location="path")], probe_path="/admin/posts/onbekend/delete"),
|
||
|
|
endpoint("GET", "/admin/joins", "Aanmeldingen", auth="admin", sample={"requests": []}),
|
||
|
|
endpoint("POST", "/admin/joins/{uid}/status", "Status aanmelding", auth="admin", fields=[field("uid", required=True, location="path"), field("status", enum=["open", "contacted", "accepted", "declined"])], probe_path="/admin/joins/onbekend/status", probe_body={"status": "open"}),
|
||
|
|
endpoint("POST", "/admin/joins/{uid}/check", "Repo-link controleren", "Haalt de titel op via de beveiligde uitgaande client.", auth="admin", fields=[field("uid", required=True, location="path")], probe_path="/admin/joins/onbekend/check"),
|
||
|
|
endpoint("GET", "/admin/services", "Services", auth="admin", sample={"services": []}),
|
||
|
|
endpoint("GET", "/admin/services/{name}", "Service", auth="admin", fields=[field("name", required=True, location="path", example="backup")], probe_path="/admin/services/backup"),
|
||
|
|
endpoint("POST", "/admin/services/{name}/command", "Service-commando", auth="admin", fields=[field("name", required=True, location="path"), field("verb", enum=["start", "stop", "run", "clear"])], probe_path="/admin/services/backup/command", probe_body={"verb": "noop"}),
|
||
|
|
endpoint("POST", "/admin/services/{name}/config", "Service-configuratie", auth="admin", fields=[field("name", required=True, location="path")], probe_path="/admin/services/backup/config", probe_body={}),
|
||
|
|
endpoint("GET", "/admin/trash", "Prullenbak", auth="admin", sample={"items": []}),
|
||
|
|
endpoint("POST", "/admin/trash/restore", "Herstellen", auth="admin", fields=[field("stamp", required=True)], probe_body={"stamp": "none"}),
|
||
|
|
endpoint("POST", "/admin/trash/purge", "Definitief verwijderen", auth="admin", destructive=True, fields=[field("stamp", required=True)], probe_body={"stamp": "none"}),
|
||
|
|
endpoint("GET", "/admin/settings", "Instellingen", auth="admin", sample={"settings": {}}),
|
||
|
|
endpoint("POST", "/admin/settings", "Instellingen opslaan", auth="admin", probe_body={}),
|
||
|
|
endpoint("GET", "/admin/users", "Accounts", auth="admin", sample={"users": []}),
|
||
|
|
endpoint("POST", "/admin/users/{uid}/role", "Rol wijzigen", auth="admin", fields=[field("uid", required=True, location="path"), field("role", enum=["Admin", "Member"])], probe_path="/admin/users/onbekend/role", probe_body={"role": "Member"}),
|
||
|
|
endpoint("GET", "/admin/audit", "Auditlog", auth="admin", sample={"rows": []}),
|
||
|
|
endpoint("GET", "/admin/backups", "Back-ups", auth="admin", sample={"backups": []}),
|
||
|
|
endpoint("POST", "/admin/backups", "Back-up inplannen", auth="admin", fields=[field("target", enum=["database", "uploads", "keys", "full"])], probe_body={"target": "nope"}),
|
||
|
|
endpoint("GET", "/admin/backups/{uid}/download", "Back-up downloaden", "Alleen de primaire beheerder.", auth="admin", negotiation="none", interactive=False, probe_path="/admin/backups/onbekend/download"),
|
||
|
|
endpoint("GET", "/admin/stats", "Statistieken", auth="admin", sample={"top_paths": [], "daily": []}),
|
||
|
|
],
|
||
|
|
}
|