API do Postman: o que dá para fazer e como usar com agentes de IA
O Postman é a ferramenta mais usada para testar e documentar APIs, e também tem uma API própria para gerenciar coleções, ambientes, workspaces, mocks e monitores. É usada por times de desenvolvimento e QA que querem automatizar a manutenção desses recursos. O acesso é feito com chave de API gerada na conta.
Os grandes recursos da API, em português claro.
Leitura, criação e atualização de coleções de requisições.
Gestão de variáveis de ambiente, como URLs de homologação e produção.
Organização de coleções e ambientes por time ou projeto.
Servidores simulados para testar integrações antes da API real ficar pronta.
Execuções agendadas de coleções para acompanhar a saúde de APIs.
Gestão de definições como OpenAPI dentro do Postman.
Como se acessa a API do Postman.
- Com credencial da sua empresaUsa chave de API gerada nas configurações da conta do Postman, enviada no cabeçalho de cada requisição.
- Documentação oficiallearning.postman.com/docs/developer/postman-api/intro-api
- Variáveis de ambiente podem conter segredos: restrinja o acesso do agente.
- Há limites de uso da API conforme o plano do Postman.
- Evite permissões de exclusão de coleções e workspaces.
- api postman
- postman api
- postman api key
- api do postman coleções
- postman api documentação
- integração postman api
O que um agente do iTeam faz com a API do Postman.
O agente usa a coleção do time como fonte de verdade dos endpoints internos e só chama o que está descrito ali.
O agente lê os resultados dos monitores e abre chamado com a requisição que falhou e a resposta recebida.
Quando a URL de homologação muda, o agente atualiza a variável nos ambientes certos e avisa o time.
O agente compara a coleção com a especificação OpenAPI e aponta endpoints sem exemplo ou removidos.
Da credencial ao agente trabalhando, com aprovação.
Gerar a chave de API
Na conta do Postman, crie uma chave de API de uma conta técnica com acesso só aos workspaces necessários.
Guardar no cofre do iTeam
Cadastre a chave e defina se o agente apenas lê coleções e monitores ou também pode editar ambientes.
Começar em leitura
Rode primeiro em modo leitura e libere edições quando o time validar os relatórios do agente.
Dúvidas sobre a API do Postman.
A API do Postman é gratuita?
A API está disponível também em planos gratuitos, com limites de uso; planos pagos ampliam esses limites e os recursos de time.
Preciso programar para usar a API do Postman com o iTeam?
Não necessariamente. O time de implantação configura o acesso e o agente pode inclusive usar as coleções existentes para aprender as suas APIs.
O iTeam importa uma coleção do Postman como ferramenta?
Uma coleção bem documentada é uma ótima base para a ferramenta HTTP do iTeam aprender os endpoints de um sistema interno.