Cross Segmentos - TOTVS CRM Automação de Força de Vendas (SFA) - WEB - Integração - Testar acesso REST através do terminal Windows e Linux

 Tempo aproximado para leitura: 00:05:00 min

Dúvida
Como realizar teste de comunicação com o serviço Rest utilizando CMD Linux e Windows?

Ambiente
Cross Segmentos - TOTVS CRM Automação de Força de Vendas (SFA) - WEB - Integração - Todas as versões

Solução

1. Com a URL de acesso ao REST em mãos, acesse o Terminal Console (em ambiente Linux) / Command Prompt (em ambiente Windows).

Atenção!
Caso não tenha a URL REST em mãos, é possível descobrir qual é a URL através do arquivo kettle.properties dentro dos fontes do SFA.

2. Dentro do terminal o comando a ser executado será:

curl -L "url_destino_rest" -v -H "Authorization: Token"

Exemplo: curl -L "https://totvssfa123456.protheus.cloudtotvs.com.br:1234/rest_sfa" -v -H "Authorization: Basic T0TV5t35t3"

• Curl: Linha de comando usada para transferir dados de ou para um servidor;
• -L: Comando que instrui a ferramenta a seguir redirecionamento;
• Url_destino_rest: URL rest montada para qual será realizada a requisição;
• -V: Fornecerá informações detalhadas sobre o que está fazendo. Isso inclui detalhes sobre a conexão, cabeçalhos enviados e recebidos;
• -H: Permite  adicionar cabeçalhos HTTP personalizados à requisição
• Authorization:  Usado para fornecer credenciais que autenticam o cliente junto ao servidor
• Token: O token é composto pelo nome de usuário e senha que são codificados em base64 e enviados no cabeçalho. Exemplo: Basic <base64(username:password)>

3. Após inserir e executar o comando, será registrado no terminal o retorno / resposta da tentativa de conexão realizada. O retorno é extenso e informa algumas estruturações do html e css da página, dentro da primeira tag retornada HTTP/1.1 será apresentado o código de retorno.

• Se o código retornado for 200 OK significa que está sendo possível se comunicar com a URL REST informada e realizar a autenticação:

• Caso o retorno seja 400 Bad request, significa que a solicitação enviada está inválida. Uma causa provável é algum erro da estruturação da URL que está sendo enviada:

• Se o retorno for 401 Unauthorized, significa que a URL está acessível, porém não foi informada as credenciais de acesso, ou foram informadas as credenciais de acesso incorretas

• Caso o retorno informe Connection refused, a url rest não está acessível, provavelmente indicando que o serviço REST não está operante;