🪄 Levels

Rollen Sync Ergebnis

Den Befund eines Auftrags holen - so oft, bis er da ist.

─── Warum es hier keinen 404 gibt ──────────────────────────────────────

Weil das Dashboard einen 404 als "kaputt" liest und nicht als "noch nicht". Ein Auftrag, der laeuft, hat kein Ergebnis - das ist kein Fehler, sondern der Normalfall der ersten Sekunden. Deshalb immer 200, und der Zustand steht im Koerper.

─── Die fuenf Lagen und was die Anzeige daraus macht ───────────────────

Der Bot legt seinen Zustand auf Deutsch ab, die Fortschrittskarte kennt vier englische - _sync_anzeige uebersetzt (Begruendung dort):

laeuft            → running    Weiter nachfragen, bis
                               `frist_sekunden` um sind.
fertig            → completed  Der Befund steht in `befund`, bei
                               einer Reparatur daneben `geaendert`,
                               `gegeben`, `entzogen`.
fehler            → failed     Ein Cluster war zustaendig und ist
                               gescheitert; `fehler` sagt womit.
nicht_zugestellt  → failed     Kein Cluster hat den Auftrag gehoert.
unbekannt         → failed     Kennung falsch, oder das Ergebnis ist
                               abgelaufen.

Warum unbekannt als Fehler und nicht als "laeuft noch": der Auftrag wird VOR dem Absenden angelegt, also gibt es zu einer gueltigen Kennung immer einen Eintrag. Ist keiner da, kommt auch keiner mehr - und ein Nachfragen alle drei Sekunden bis zum Schliessen des Reiters waere die Antwort auf eine Frage, die schon entschieden ist.

Die einzige Ausnahme ist 503: ohne Redis gibt es keinen Ort, an dem ein Ergebnis liegen koennte, und "abgelaufen" waere dafuer die falsche Auskunft.

─── Warum eine fremde Kennung nichts findet ────────────────────────────

Der Schluessel wird aus der Server-ID im Pfad gebaut, und die hat validate_server_access geprueft. Eine Kennung von einem anderen Server trifft damit ins Leere, statt dessen Mitgliederliste auszuliefern.

get/api/v1/servers/{server_id}/level/rollen-sync/{auftrag_id}

Request

  • Base URL: https://api.notoq.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.notoq.xyz/api/v1/servers/{server_id}/level/rollen-sync/{auftrag_id}
  • Auth: HTTP bearer

Path parameters

server_idstring required

Discord Server ID

auftrag_idstring required

Response

Successful Response

successboolean required
dataobject required
messagestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.