Como interagir com APIs de rede usando cURL, ferramentas Postman

Getty Images

As APIs estão simplificando a maneira como os engenheiros de rede trabalham no setor. Eles governam o mundo de alta tecnologia, de smartphones e smartwatches à Estação Espacial Internacional e data centers em todo o mundo.

Os engenheiros que já trabalharam com APIs provavelmente não retornarão aos dias tradicionais de uma interface de linha de comando (CLI) e sintaxes infinitas, que geralmente produzem erros que resultam em interrupções de rede e perda de receita para as empresas. As APIs são as novas CLIs.

Em meu artigo anterior sobre casos de uso de APIs de rede, fiz uma visão geral do que são APIs, seus casos de uso e por que os engenheiros de rede devem adotá-las em um mundo onde a agilidade é fundamental para fornecer serviços de alto nível. Este artigo explora como os engenheiros de rede podem usar ferramentas como cURL e Postman para interagir com APIs de rede.

A maioria dos engenheiros de rede já ouviu falar sobre cURL e Postman em várias comunidades de redes e desenvolvedores. O Postman é uma plataforma de teste de API baseada em GUI com mais de 20 milhões de usuários em todo o mundo. Ele ajuda os desenvolvedores a projetar, construir, testar e melhorar suas APIs com mais iterações. O uso da ferramenta simplifica os fluxos de trabalho da API em ambientes de teste e produção.

A ferramenta de linha de comando cURL é usada para enviar dados de e para o servidor. A ferramenta é amplamente utilizada por causa de seus recursos avançados, como suporte multiprotocolo - especialmente HTTP e HTTPS.

Para usar o Postman e o cURL, os engenheiros de rede precisam determinar qual verbo HTTP usar para interagir com as infraestruturas. Uma maneira de fazer isso é vincular verbos HTTP para criar funções de leitura, atualização e exclusão (CRUD) usadas pelos bancos de dados.

PUBLICAR

CRIAR

PEGAR

LER

COLOCAR

ATUALIZAR

CORREÇÃO

ATUALIZAR

EXCLUIR

Em redes, Secure Shell (SSH) é um protocolo amplamente utilizado para acesso remoto seguro a dispositivos de rede. Mas com a crescente necessidade de automação e uso de APIs para dispositivos de rede, os engenheiros de rede precisam de uma interface para interagir com as APIs do dispositivo de forma programável.

Os protocolos HTTP ou HTTPS podem interagir com APIs de dispositivos de rede usando ferramentas CLI e GUI, como cURL e Postman, respectivamente. Essas interações podem obter dados ou manipular dados. No campo de rede, os dados são principalmente configurações de dispositivos. Essas ferramentas ajudam os engenheiros a integrar dispositivos de rede com outros sistemas de gerenciamento de rede, além de melhorar a eficiência da rede e automatizar os processos de rede.

Vamos entrar e interagir com uma API de dispositivo via HTTPS usando cURL e Postman. Observação: você deve entender claramente a documentação da API do dispositivo por meio das operações CRUD comuns a todas as APIs.

Os exemplos abaixo mostram diferentes cenários nos quais os engenheiros de rede podem usar o cURL e a GUI do Postman em uma caixa de proteção ou ambiente de produção.

As tarefas incluem o seguinte:

Os engenheiros de rede sempre precisam fazer login nos dispositivos de rede, como switches e roteadores. Para fazer isso, os engenheiros podem acessar uma rede remota usando uma CLI de sandbox e fazer login com um endereço IP. No exemplo abaixo, efetuamos login em um roteador com endereço IP 172.31.0.1 via HTTPS usando o seguinte comando:

Aqui "-k" ignora a certificação Secure Sockets Layer e "-u" é incluído para mencionar o nome de usuário com a senha.

O uso do cURL é uma maneira eficaz de acessar dispositivos de rede remotamente, pois oferece suporte a vários protocolos.

A próxima etapa é coletar informações da interface, como endereço principal, descrição e informações de encaminhamento. Essas informações são úteis para engenheiros de rede enquanto eles analisam e solucionam problemas de redes.

Para inspecionar uma interface em um dispositivo Cisco, os engenheiros geralmente usam o seguinte comando Cisco IOS:

Os engenheiros podem usar cURL para fazer a mesma tarefa. Uma opção é obter as informações da interface em JSON. Atualmente, o formato de dados JSON é usado como padrão para troca de dados, e muitas linguagens e ferramentas de programação o suportam. JSON é legível por humanos e analisável por máquina. Assim, os engenheiros podem precisar de informações de interface no formato JSON para integrá-lo a uma API ou usar na automação de rede.