Postman - Como usar e importar uma Collection

O que é o Postman?

O Postman é uma plataforma de API para desenvolvedores projetar, construir, testar e iterar suas APIs.

Com o Postman você consegue simular requisições a API do AgoraOS (e de qualquer outro sistema de API).

Você pode baixar o Postman App para o Windows neste link, não é necessário se cadastrar. 

https://www.postman.com/downloads/

O que é um Postman Collection?

O Postman Collection é uma coleção de links de API, com seus respectivos metodos (POST, GET, PUT, etc) e demais configurações de envio como headers, body, entre outros.

Eventualmente, nós do suporte do AgoraOS iremos gerar uma coleção de links de exemplo para você utilizar na sua realidade.

Em geral, fazemos isso caso a documentação da API em questão ainda não esteja pronta ou para dar exemplos prontos de uso para os nossos clientes.

Como usar o Postman Collection?

Caso o suporte te de um link de coleção, por exemplo:
"https://www.getpostman.com/collections/9cdee5949e4aa28accc"

1. Importe esse link dentro do Postman na opção File > Import.

2. Na janela que abrir, selecione a opção "Import From Link" (importar de link, se o seu Postman estiver em português).

3. Navegue na coleção criada no "Collections" dentro do Postman.

Neste exemplo, a coleção se chama LEV.

4. Para usar a API, o primeiro item da coleção que você deve acessar é o de autenticação

POST /api/v1/login/auth

Agora, veja o artigo: Como se autenticar na API