API on Cisco Redes

Cisco Meraki – APIs, como consultar?

Mon, 26 Aug 2019 00:00:00 +0000

Olá Pessoal,

Como vocês já haviam vistos em nosso post anterior e portanto recomendo que você leia ele anteriormente, para que possamos seguir para os próximos passos é de fato consultar nossas APIs e entender o que ela de fato está nos trazendo de informação.

Baseado neste fato, vamos demonstrar para vocês os primeiros passos para que comece interagir via API com seus equipamentos Meraki. Baseado na documentação temos alguns pontos importantes para inserir como variável, tornando assim sua vida um pouco mais fácil nos momentos de executar um ” Get “, “ Post “, ” Put ” e ” Delete “.

Talvez você me pergunte, porque temos esses status para executar as ações via API? Esses termos existem devido a trabalhar com essa metodologia ” Restfull ” ( ixi, acho que agora ele me confundiu mais 🙂 ), entretanto nós já haviamos mencionado isso em outro post de 2017 ( O que é API e Rest API? ). E para ficar ainda mais fácil o entendimento, observe que essas ações estão relacionadas ao funcionamento do HTTP, onde se desejar obter mais informações pode consultar Wikipedia ou propriamente a RFC7231.

Com isso em mente, precisamos agora entender que para conseguirmos obter os dados relacionados a sua organização criada no portal Meraki, precisaremos encontrar além de nossa API Key mais duas informações:

- Organization ID
- Network ID

Como uma dica para que não fique muito extensa sua ” URL ” sendo executada no Postman, é recomendado que você crie uma ” baseURL ” que por consequência ela sempre vai ser a mesma para qualquer solicitação que fizer no dashboard. Segue a variável:

- baseURL = https://dashboard.meraki.com/api/v0

Execução do Postman

Dando sequencia a execução das informações via Postman vamos obter os dados relacionado a nossa segunda variável depois de inserir sua Key API. Para inserir sua KEY recomenda-se criar um ambiente de variáveis para controlar suas requisições ou também controlar varios ambientes com diferentes variáveis. Para criar você deve selecionar Manage Environments -> ADD

Após este passo devemos agora obter nossa segunda variável para continuarmos trabalhando na execução e obter as informações globais para acesso completo as APIs. Neste momento vamos obter as informações relacionadas ao “ OrganizationID “

- Metodo: GET
- URL: https://dashboard.meraki.com/api/v0/organizations

Após essa informação precisamos obter nosso terceiro dado ( variável ) para que de fato possamos dar sequencia a qualquer outra requisição dentro de nossa organização, onde ela vai agora basear-se no ” NetworkID “:

- Metodo: Get
- URL: https://dashboard.meraki.com/api/v0/organizations/{{organizationId}}/networks

Como mencionado anteriormente você pode criar sua ” baseURL ” para inserir em suas variáveis globais, desta forma sua URL no Postman fica mais “ enxuta “, pois esse é o endereço inicial padrão da Meraki.

Com esses dados obtidos todas as outras solicitações ao portal serão baseando-se em algum momento nessas variavéis, tendo URL sendo requisitadas as duas informações simultaneamente ou momentos de apenas uma única variavél.

Espero que vocês tenham gostado 😆 e demos mais um passo para que possamos seguir nossa jornada para programar ações via Ansible em nosso dashboard Meraki.

Qualquer dúvida deixe seus comentários abaixo que vamos compartilhando nosso conhecimento entre todos da comunidade.

Abs,
Rodrigo

Cisco Meraki – Facilidades através de APIs

Tue, 06 Aug 2019 00:00:00 +0000

Olá Pessoal,

Como vocês podem observar hoje vamos explorar um mundo um pouco diferente, o qual vou demonstrar como habilitar o recurso de APIs dentro do portal Meraki, e desta forma ter um mundo gigantesco de oportunidades para trabalhar com os diferentes recursos existentes nesta solução.

Vale ressaltar que neste portal podemos criar ao mesmo tempo duas APIs, ou seja, você pode executar com os mesmo privilegios utilizando uma dessas APIs criadas. Não entraremos nos detalhes relacionado a segurança, mas vale lembrar que essa chave é instrasferível, e a partir do momento que é compartilhada com alguém ela terá total acesso a qualquer funcionalidade de seu portal.

Como Habilitar API no Portal

Após acessar seu portal você deve ir em Organization -> Configure -> Settingse habilitar essa funcionalidade, entretanto vale lembrar que para isso precisaremos garantir que já temos nosso token criado no portal e que assim possamos utilizar em outras ferramentas. Veja abaixo:

Após acessar seu profile como indicado acima, você será redirecionado para avaliar suas ” Keys “, se já tiver sua API, perfeito, entretanto se já tenho esquecido irá precisar ser gerado uma nova, pois o texto não é recuperado para ” copiar e colar “. Veja abaixo minha chave já existente.

Caso não seja visualizado nenhuma, será necessario apenas clicar em ” Generate new API Key ” e logo após ela gera automaticamente conforme abaixo.

Após esse processo você já pode visualizar suas chaves e quando foi a última vez que ela foi utilizada. PS.: Como informado anteriormente podemos ter duas chaves ao mesmo tempo criada.

Após esse processo você pode me perguntar, o quê eu vou fazer com isso?

Bem, poderiamos colocar milhares de opções aqui, mas vou deixar você pensar em alguma e se quiser pode colocar em nossos comentários e assim exploramos opções para discutirmos.

Como usar as APIs

Para que possamos começar a explorar este vasto universo de opções que temos, eu recomendo utilizar a ferramenta denominada Postman, que por sua vez é gratuita, e mesmo na versão ” free ” temos milhares de opções como salvar o histórico das APIs consultadas, criar variáveis de ambiente global ou para suas bibliotecas, criar pastas para registro de todas as APIs para futura validação, etc.

Abaixo você pode conferir a tela inicial e de fato observar minhas ” Collection ” e também os diferentes ” WorkSpace ” que você pode criar para facilitar no seu dia a dia.

Como estamos falando de Meraki você pode consultar facilmente o portal, para pesquisar qual API deseja utilizar, bem como ter uma interatividade em relação qual a resposta que devemos esperar após consultar API desejada em qualquer dashboard Meraki.

Para visualizar acesse o link de APIs Meraki e visualize conforme abaixo. Vale ressaltar que para esse caso você consegue fazer o download de todas as APIs ( pastas + URL ) diretamenta já para seu Postman, basta clicar em ” Run in Postman ” e ele fará todo o download para seu postman instalado. 🙂

Caso você esta tendo algum problema para consultar seus dados, valide seu token bem como se as informações relacionadas a sua organização ( Meraki Dashboard ) é correspondente com aquilo que você esta consultando.

Espero que vocês tenham gostado e deixem seu feedback abaixo, bem como também respondendo sobre nosso questionamento no meio de nosso post. Nos aguarde que iremos mostrar como navegar dentro dessas APIs e mostrar consultas via Ansible.

Abs,
Rodrigo

API – DevNet

Thu, 16 Feb 2017 00:00:00 +0000

Olá Pessoal,

Acredito que você tenha lido nosso post anterior sobre API e conforme informado vou trazer alguns ítens que venho acompanhando nessa área que estamos trabalhando ( Routing & Switching e DC ).

Como venho falando em alguns posts anteriores nossa área está alterando-se e devido a isso muitas movimentações estão acontecendo nas organizações para se adequar as novas tendências bem como re-estruturar seus produtos para que os concorrentes não atropelem e definitivamente as marcas não caiam no desuso.

Acredito que vocês souberam da última aquisição da Cisco de uma empresa chamada “ APPDynamics “, pois bem, se observarmos é mais uma empresa tendo seu core business para aplicações. Além disso, podemos observar as ultimas aquisições da Cisco pelo link ( Cisco Acquisition ).

Olhando neste cenário de aquisições da Cisco, qual é a maioria do core business dessas empresas compradas pela Cisco? Se você pensou empresas de software, está correto.

Devido essas novas demandas que estão surgindo exponencialmente, ela como uma gigante não pode ficar esperando ( porém eu achei que ela demorou para acreditar nisso ) que outros fabricantes roubem muito seu mercado, desta forma hoje eles já tem times especificos e uma grande comunidade que está desenvolvendo para que os equipamentos, com sua APIs sejam utilizadas por qualquer desenvolvedor ou fabricante.

Como podem observar pela foto acima Cisco esta trazendo essa menção chamada DevNet, onde já temos o site Developers Cisco, que traz diversas informações relacionados aos desenvolvimento de cada plataforma. Para cada plataforma nós já podemos consultar as APIs publicas baseando-se em cada torre de tecnologia ( Cloud, Networking, Datacenter, etc ).

Se vocês navegarem pelo site, podemos mencionar ainda que não temos muitos ítens disponibilizados para executar as tarefas, mas com certeza eu acredito que isso vai crescer exponencialmente. Vocês acham que isso pode crescer?

Em nosso proximo post vou mencionar um pouco mais sobre o SandBox

Abs,
Rodrigo

O que é API e Rest API?

Mon, 13 Feb 2017 00:00:00 +0000

Olá Pessoal,

Devido as novas demandas que estão surgindo, principalmente a relação de integração de software com nossa infraestrutura ( routers, switches, firewalls ) esses termos mencionados em nosso título acabam sendo evidenciados.

Acredito que todos quando observam esses termos imaginam que isso seja algo relacionado a quem trabalha com programação, integração de sistemas, desenvolvedores de sistemas, etc.

Pois bem, isso não é mais a realidade que vivenciamos em nossa área de redes e infraestrutura. Porquê? 💡

Como todos nos sabemos nossa área esta passando por várias transformações, bem como as empresas estão adicionando em seus produtos muitas funcionalidades que podem ser visualizadas / consultadas por outros fabricantes, com o intuito de oferecer serviços e integrações entre as plataformas. Com isso podemos definir dois ítens:

API ( Application Programming Interface ) : Isso está relacionado a ferramenta ou biblioteca que pode ajudar aos desenvolvedores acessarem informações dentro de seu código ( fabricante ) para fazer a tratativa das informações necessária para o desenvolvimento de sua ferramenta. Essas APIs podem estar contidas nos sistemas operacionais, sistema de banco de dados, hardware de computadores, etc. No caso de uma API podemos mencionar que pensando no protocolo HTTP você poderia fazer um ” GET ” no código para obter as informações.

Como exemplo de uma API poderíamos citar dois exemplos:

Quando acessamos um site onde vamos pesquisar seu endereço e nele temos o mapa do ” Google MAPS ” populados automaticamente na página daquele cliente, e da mesma forma podemos navegar nessa janela olhando pelas ruas próximas ao mapa, ou seja, o site está acessando uma API publica do Google para mostrar aquela informação.
Poderíamos citar sobre o Facebook que disponibiliza uma API para que por exemplo outros software possam fazer uma publicação automatica baseado na sua autorização de utilização da API ( Keys ).

Rest API ( Representational state transfer API ) : Como informado acima API oferece caminhos para que você possa acessar as informações, e quando a menção se torna uma REST API seria quando eu defino funções a qual os desenvolvedores podem executar solicitações e receber respostas por exemplo através do protocolo HTTP ( GET e POST )

Com isso diversas plataforma agora estão vindo com API públicas para que você possa consultar e de alguma forma possa interagir com as ferramentas / hardware que esse fabricante disponibiliza. Você poderia estar pensando o que vou fazer com essas funcionalidades?

Em nosso segundo post vou mencionar sobre o que fazer com essas funcionalidades e como a Cisco está trabalhando com essas novas demandas.

Abs,
Rodrigo