피드백

이 서버를 통해 ProAnimaStudio로 보내는, 스크린샷과 로그가 포함된 보고서.

이 그룹의 작업과 각 작업의 액세스 규칙, 재시도 규칙, 매개 변수, 응답입니다. 모든 요청에는 키가 포함됩니다: Authorization: Bearer <키>(“인증” 참조).

작업

ProAnimaStudio에 피드백 보내기

POST /api/v1/feedback

액세스: 유효한 키 또는 세션 · 재시도: 자동으로 반복하지 않음

이 서버를 거쳐 ProAnimaStudio 허브로 메시지를 전달하고, 허브의 id와 함께 202로 응답합니다. message(최대 20,000자), lang(ru 또는 en), serverLog(true이면 이 서버의 로그와 시스템 요약을 첨부하며 관리자만 가능)를 보내고, 선택적으로 답장을 받을 email, screen, base64로 인코딩한 screenshots(PNG, JPEG, WebP, GIF, 각 8 MiB, 최대 6개), 콘솔의 clientLog를 보냅니다. 전체 크기는 15 MiB로 제한됩니다. 서버는 재시도하지 않으므로 두 번째 호출은 두 번째 메시지가 됩니다. 운영자가 껐으면 503 feedback_disabled, 허브가 응답하지 않으면 503 hub_unreachable, 이 서버가 너무 많이 보냈으면 429 feedback_attempts입니다.

요청 본문 (application/json)

필드	형식	필수	규칙
message	string	예	1–20000자
email	string	아니요	254자 이하; null일 수 있음
lang	string	예	ru, en 중 하나
screen	string	아니요	11자 이하; null일 수 있음
screenshots	object 배열	예	요소 6개 이하
screenshots[].name	string	예	1–120자
screenshots[].type	string	예	image/png, image/jpeg, image/webp, image/gif 중 하나
screenshots[].data	string (byte)	예	—
clientLog	string	아니요	2097152자 이하; null일 수 있음
serverLog	boolean	예	—

응답 202

필드	형식	필수	규칙
id	string	예	—

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

예제

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

피드백 첨부 파일 미리 보기

GET HEAD /api/v1/feedback/attachments

액세스: 관리자 · 재시도: 반복해도 안전함(읽기)

serverLog가 true일 때 sendFeedback이 첨부하는 두 텍스트, 즉 이 서버 로그의 최근 기록과 시스템 요약(버전, 운영 체제, 업데이트 및 미러 상태이며 주소, 이름, 비밀 값은 제외)을 반환합니다. 보내기 전에 관리자에게 보여 줍니다.

응답 200

필드	형식	필수	규칙
serverLog	string	예	—
system	string	예	—

응답: 200, 400, 401, 403, 404, 409, 422, 503, 507

예제

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