Feedback

Berichte mit Screenshots und Protokollen, die über diesen Server an ProAnimaStudio gesendet werden.

Die Vorgänge dieser Gruppe mit ihrer Zugriffsregel, Wiederholungsregel, ihren Parametern und Antworten. Jede Anfrage trägt einen Schlüssel: Authorization: Bearer <Schlüssel> (siehe „Authentifizierung“).

Vorgänge

Feedback an ProAnimaStudio senden

POST /api/v1/feedback

Zugriff: Jeder gültige Schlüssel oder jede gültige Sitzung · Wiederholung: Nicht automatisch wiederholen

Leitet eine Nachricht über diesen Server an den ProAnimaStudio-Hub weiter und antwortet mit 202 und der id des Hubs. Senden Sie message (bis zu 20.000 Zeichen), lang (ru oder en), serverLog (true hängt das Log dieses Servers und eine Systemzusammenfassung an, nur für Administratoren) und optional email für eine Antwort, screen, bis zu 6 base64-kodierte screenshots (PNG, JPEG, WebP oder GIF, je 8 MiB) und das clientLog der Konsole; die Gesamtgröße ist auf 15 MiB begrenzt. Es wird nichts wiederholt, ein zweiter Aufruf ist also eine zweite Nachricht. 503 feedback_disabled, wenn der Betreiber es abgeschaltet hat, 503 hub_unreachable, wenn der Hub nicht antwortet, 429 feedback_attempts, wenn dieser Server zu viel gesendet hat.

Anfragetext (application/json)

Feld	Typ	Erforderlich	Regeln
message	string	ja	1–20000 Zeichen
email	string	nein	höchstens 254 Zeichen; darf null sein
lang	string	ja	einer von ru, en
screen	string	nein	höchstens 11 Zeichen; darf null sein
screenshots	Array von object	ja	höchstens 6 Elemente
screenshots[].name	string	ja	1–120 Zeichen
screenshots[].type	string	ja	einer von image/png, image/jpeg, image/webp, image/gif
screenshots[].data	string (byte)	ja	—
clientLog	string	nein	höchstens 2097152 Zeichen; darf null sein
serverLog	boolean	ja	—

Antwort 202

Feld	Typ	Erforderlich	Regeln
id	string	ja	—

Antworten: 202, 400, 401, 403, 404, 405, 409, 413, 415, 422, 503, 507

Beispiel

curl -X POST "$ARKVORY_URL/api/v1/feedback" \
  -H "Authorization: Bearer $ARKVORY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"<message>","lang":"ru","screenshots":[],"serverLog":false}'

Feedback-Anhänge in der Vorschau anzeigen

GET HEAD /api/v1/feedback/attachments

Zugriff: Administrator · Wiederholung: Wiederholen ist sicher (Lesen)

Liefert die beiden Texte, die sendFeedback anhängt, wenn serverLog true ist: die jüngsten Einträge des Logs dieses Servers und eine Systemzusammenfassung (Versionen, Betriebssystem, Update- und Spiegelzustände) ohne Adressen, Namen oder Geheimnisse. Zeigen Sie sie dem Administrator vor dem Senden an.

Antwort 200

Feld	Typ	Erforderlich	Regeln
serverLog	string	ja	—
system	string	ja	—

Antworten: 200, 400, 401, 403, 404, 409, 422, 503, 507

Beispiel

curl -X GET "$ARKVORY_URL/api/v1/feedback/attachments" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"