Status: 400 Bad Request, com dados: "message": "The query specified in the URI is not valid. A binary operator with incompatible types was detected. Found operand types 'Movidesk.Core.Data.Enums.TicketOrigin' and 'Edm.Int32' for operator kind 'Equal'." e semelhantes
Motivo
Esse erro ocorre quando se está tentando utilizar alguma expressão comparativa, como no parâmetro de “$filter”, com campos de ENUM (enumerados) e comparando-os com seus valores inteiros, em vez de usar a enumeração.
Um exemplo de requisição GET com esse erro, é:
https://api.movidesk.com/public/v1/tickets?token={{Token}}&$select=id&$filter=origin eq 3
Nesse caso, a requisição está tentando filtrar os tickets cujo atributo de “origin” (origem do ticket, ou por onde foi aberto) seja igual a “3”.
Verificando em nossa documentação da API de Tickets, é possível identificar que a origem 3 seria os tickets abertos via e-mail.
Resolução
Nesse caso, a resolução é bem prática. Basta tratar o dado como um enumerado.
O ENUM que deve ser utilizado geralmente é retornado na mensagem de erro da requisição mesmo, como neste caso, onde seria retornado o erro "message": "The query specified in the URI is not valid. A binary operator with incompatible types was detected. Found operand types 'Movidesk.Core.Data.Enums.TicketOrigin' and 'Edm.Int32' for operator kind 'Equal'."
Para ajustar isso na consulta à API, basta envolvermos o número de origem que estamos buscando (3) por aspas simples, e, antes da primeira aspa, colocar o ENUM desejado por extenso. A requisição ficaria assim:
https://api.movidesk.com/public/v1/tickets?token={{Token}}&$select=id&$filter=origin eq Movidesk.Core.Data.Enums.TicketOrigin'3'
Abaixo, segue imagem exibindo o retorno da consulta, dentro do esperado:
Em nosso artigo da API sobre os ENUMS e sua utilização em filtros, também disponibilizamos uma lista com os ENUMS das API’s do Movidesk, e como podem ser utilizados para consultas.