Motrix

Enviar resultado de avaliações

POST /api/v1/motrix/update_user_result

Este endpoint é responsável pela atualização da avaliação de um usuário.

Atributos

Campo	Tipo	Obrigatório	Descrição
`user_id`	number	sim	ID de referência da Árvore. Ex: `123`
`assessment_id`	number	sim	ID de referência da avaliação passado no início da sessão. Ex: `123`
`status`	enum	sim	Status do resultado: `CLOSED`, `EXPIRED` ou `OPEN`
`degree`	enum	sim	Ano escolar do aluno: `1`–`5` (EF I), `6`–`9` (EF II)
`complexity_percentile`	number	sim	Percentil da complexidade calculada
`complexity_index`	number	sim	Índice da complexidade calculada
`decodification_percentile`	number	sim	Percentil da decodificação calculada
`decodification_index`	number	sim	Índice da decodificação calculada
`comprehension_percentile`	number	sim	Percentil da compreensão calculada
`comprehension_index`	number	sim	Índice da compreensão calculada
`success`	boolean	sim	Indica se a avaliação foi bem sucedida ou não
`reason`	string	não	Motivo do erro, caso a avaliação não tenha sido bem sucedida

Request

POST /api/v1/motrix/update_user_result
Authorization: APIAuth access_key_id:signature
Content-MD5: <hash-content-md5>
DATE: Thu, 03 Dec 2020 16:43:58 GMT

{
    "user_id": 123,
    "assessment_id": 123,
    "degree": "1",
    "complexity_percentile": 12.0,
    "complexity_index": 2.0,
    "decodification_percentile": 12.0,
    "decodification_index": 2.0,
    "comprehension_percentile": 12.0,
    "comprehension_index": 2.0,
    "success": true,
    "status": "CLOSED"
}

Response

200 OK

{
    "success": true,
    "data": {
        "message": "User assessment result updated!"
    }
}

400 Bad Request — quando não envia os campos requeridos corretamente.

{
    "success": false,
    "errors": [
        {"assessment_id": ["can't be blank"]},
        {"complexity_index": ["can't be blank"]},
        {"complexity_percentile": ["can't be blank"]},
        {"comprehension_index": ["can't be blank"]},
        {"comprehension_percentile": ["can't be blank"]},
        {"decodification_index": ["can't be blank"]},
        {"decodification_percentile": ["can't be blank"]},
        {"degree": ["can't be blank"]},
        {"status": ["can't be blank"]},
        {"success": ["can't be blank"]},
        {"user_id": ["can't be blank"]}
    ],
    "status_code": 400
}

400 Bad Request — quando envia um user_id inválido.

{
    "success": false,
    "errors": [
        {"user": ["does not exist"]}
    ],
    "status_code": 400
}