Оценки игроков

Операции выполняются через общий API с сессией игрока и выбранным игровым сервером. Ответы используют шкалу от 1 до 5.

Доступные Вопросы

QuerydocumentId: pendingEvaluationsauth: Bearer session

pendingEvaluations

Переменные не нужны. Результат: [PlayerEvaluationInvitation!]!. Пустой массив означает, что новых вопросов нет.

Поле	Тип	Значение
id	ID!	Идентификатор приглашения; передайте его при ответе.
category	PlayerEvaluationCategory!	PROJECT, SERVER, SHOP или SUPPORT.
gameServerId	Int!	Игровой сервер вопроса.
invitedAt	String!	Дата приглашения в UTC, RFC 3339.

Запрос

{
  "documentId": "pendingEvaluations",
  "variables": {}
}

Ответ

{
  "data": {
    "pendingEvaluations": [
      {
        "id": "019a00a1-9876-7000-8000-000000000001",
        "category": "PROJECT",
        "gameServerId": 1,
        "invitedAt": "2026-09-18T12:00:00.000000Z"
      }
    ]
  }
}

Отправить Оценки

MutationdocumentId: answerEvaluationsauth: Bearer session

answerEvaluations

Поле	Тип	Условия
input	AnswerEvaluationsInput!	Обязательный объект.
input.answers	[PlayerEvaluationAnswerInput!]!	От 1 до 4 ответов.
input.answers[].invitationId	ID!	UUID из pendingEvaluations, без повторов в одном запросе.
input.answers[].score	Int!	Целое число от 1 до 5.

Результат: [PlayerEvaluationAnswer!]!. Каждый ответ содержит invitationId: ID!, score: Int! и answeredAt: String! в UTC, RFC 3339. Можно ответить только на часть вопросов. Уже отправленную оценку нельзя изменить. Повтор того же ответа возвращает сохранённый результат.

Запрос

{
  "documentId": "answerEvaluations",
  "variables": {
    "input": {
      "answers": [
        {
          "invitationId": "019a00a1-9876-7000-8000-000000000001",
          "score": 5
        }
      ]
    }
  }
}

Ответ

{
  "data": {
    "answerEvaluations": [
      {
        "invitationId": "019a00a1-9876-7000-8000-000000000001",
        "score": 5,
        "answeredAt": "2026-09-18T12:05:00.000000Z"
      }
    ]
  }
}

Ошибки

• UNAUTHENTICATED: восстановите сессию игрока.
• SERVER_REQUIRED: выберите игровой сервер и повторите запрос.
• EVALUATION_UNAVAILABLE: обновите список доступных вопросов.
• EVALUATION_ALREADY_ANSWERED: оценка уже отправлена; её нельзя заменить другой.

Ошибки значений полей возвращаются в errors[].extensions.validation. Исправьте указанные поля в списке ответов. Несоответствие типу GraphQL, например строка вместо целого числа, возвращается в errors[].message.

Формат ошибок описан в общем справочнике.