Consultar status de Atendimentos via API

Estimated reading: 2 minutes 461 views

Confira a documentação de uso da API para consultar o status de um protocolo de atendimento.

Pré-requisitos

Para utilizar esta API existe a seguinte regra:

O usuário precisa ter em seu perfil a permissão Consultar status de atendimento via api.
Para liberar o acesso basta acessar: Administração > Usuários > Perfil, escolher o perfil desejado e então habilitar a permissão Consultar status de atendimento via API.

Para autenticar um usuário na plataforma, utilize o seguinte endpoint: /api/usuario/login

No retorno com sucesso para o método post será exibido uma mensagem contendo o token de acesso aos demais endpoints dessa API.

Parâmetros no JSON	Descrição
login	Credencial de acesso do usuário na plataforma com permissão para alterar status de atendimentos
senha	Credencial de autenticação do usuário na plataforma com permissão para alterar status de atendimentos

{

“login”: “user.api”,
“senha”: “1234”

}

O retorno da chamada para o endpoint poderá ser um dos status a seguir:

SUCESSO

ERRO

Usuário não encontrado
Senha inválida
Houve um problema para gerar um token
Este campo é obrigatório – login
Este campo é obrigatório senha
Access denied (Usuário sem permissão)
Token is missing (Request sem token)
JWT expired at ano-mes-data-hora Current Time: ano-mes-data-hora, a difference of number milliseconds. Allowed clock skew: number miliseconds. (Token expirado)
*JWT signature does not match locally computed signature. JWT validity cannot be asserted and should not be trusted. (Token com falha)

Para consultar status de um protocolo de atendimento na plataforma, utilize o seguinte endpoint: api/atendimentos/status/numerodoprotocolo

No endpoint numerodoprotocolo deve ser informado o número do protocolo do Citrus para realizar a consulta.

Este endpoint poderá ser usado para consultar protocolos de atendimento com os seguintes status:

{
“protocolo”: “202301024000001”,
“status”: “Finalizado”,
}

O retorno da chamada para o endpoint poderá ser um dos status a seguir:

SUCESSO

ERRO