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.
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
Discord Server ID
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.