Cisco Meraki — APIs, como consultar?
Olá comunidade,
Fique ligado no TechRebels e siga-me no Medium clicando no follow lá em cima para receber as notificações dos meus posts.
Como não podemos esquecer, aqui vão algumas dicas inicias para que possamos entrar neste mundo de APIs e para seguir nossa linha de raciocíonio vou obviamente trazer em cima de nossa solução Meraki. :)
Se você não viu nosso primeiro post dessa serie recomendo fortemente ler:
- Cisco Meraki — Facilidades através de APIs
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 “:
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.
Espero que vocês tenham gostado e comente com sugestões e não deixe de seguir o TechRebels e a mim aqui no Medium clicando no “ follow ” ali embaixo.
Rodrigo Alexandre Rovere — CCIE#52315 — Fundador do BLOG ( www.ciscoredes.com.br) apaixonado por tecnologia.
