Comentarios

Informes con capturas de pantalla y registros enviados a ProAnimaStudio a través de este servidor.

Operaciones de este grupo con su regla de acceso, su regla de reintento, sus parámetros y sus respuestas. Cada solicitud lleva una clave: Authorization: Bearer <clave> (consulte «Autenticación»).

Operaciones

Enviar comentarios a ProAnimaStudio

POST /api/v1/feedback

Acceso: Cualquier clave o sesión válida · Reintento: No repetir automáticamente

Reenvía un mensaje a través de este servidor al hub de ProAnimaStudio y responde 202 con el id del hub. Envíe message (hasta 20 000 caracteres), lang (ru o en), serverLog (verdadero adjunta el log de este servidor y un resumen del sistema, solo para administradores) y, opcionalmente, email para recibir respuesta, screen, hasta 6 screenshots en base64 (PNG, JPEG, WebP o GIF, 8 MiB cada una) y el clientLog de la consola; el total está limitado a 15 MiB. No se reintenta nada, así que una segunda llamada es un segundo mensaje. 503 feedback_disabled cuando el operador lo desactivó, 503 hub_unreachable cuando el hub no responde y 429 feedback_attempts cuando este servidor ha enviado demasiados mensajes.

Cuerpo de la solicitud (application/json)

Campo	Tipo	Obligatorio	Reglas
message	string	sí	1–20000 caracteres
email	string	no	hasta 254 caracteres; puede ser null
lang	string	sí	uno de ru, en
screen	string	no	hasta 11 caracteres; puede ser null
screenshots	array de object	sí	hasta 6 elementos
screenshots[].name	string	sí	1–120 caracteres
screenshots[].type	string	sí	uno de image/png, image/jpeg, image/webp, image/gif
screenshots[].data	string (byte)	sí	—
clientLog	string	no	hasta 2097152 caracteres; puede ser null
serverLog	boolean	sí	—

Respuesta 202

Campo	Tipo	Obligatorio	Reglas
id	string	sí	—

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

Ejemplo

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}'

Previsualizar los adjuntos de los comentarios

GET HEAD /api/v1/feedback/attachments

Acceso: Administrador · Reintento: Se puede repetir (lectura)

Devuelve los dos textos que sendFeedback adjunta cuando serverLog es verdadero: las entradas recientes del log de este servidor y un resumen del sistema (versiones, sistema operativo, estados de actualización y de espejos) sin direcciones, nombres ni secretos. Muéstrelos al administrador antes de enviar.

Respuesta 200

Campo	Tipo	Obligatorio	Reglas
serverLog	string	sí	—
system	string	sí	—

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

Ejemplo

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