Rating

Avaliação

Para efetuar a avaliação de uma determinada corrida, é preciso passar o valor numérico do rating variando de 0 (pior nota) a 5 (melhor nota) e o ID da corrida em questão.

Lembrando que apenas o usuário que efetuou a corrida pode avaliá-la!

A checagem do usuário é feita pela API_KEY, que deve (sempre!) ser enviada.

Chamada

A chamada para criação e atualização é feita no mesmo endpoint, com POST, conforme segue:

POST https://[ambiente].loggi.com/api/v1/avaliar/

Payload

Campo Conteúdo req
order ID do pedido
rating nota de 0 a 5
notes descrição  

Retorno (Sucesso)

O retorno é um HTTP 201, contendo o rating completo e serializado.

Retorno (Falha)

O retorno é um HTTP 400, contendo o descritivo do erro.

Deleção da avaliação

Desavaliar uma corrida é permitido apenas ao usuário que a avaliou.

Chamada

A chamada para deleção é um HTTP DELETE com o pk da avaliação:

DELETE https://[ambiente].loggi.com/api/v1/avaliar/[pk]/

Retorno (Sucesso)

O retorno é um HTTP 204.

Retorno (Falha)

Quando não encontrado ou quando não tem permissão para excluir, o retorno é um HTTP 404. Quando ocorre um erro na deleção, o retorno é um HTTP 500.