O documento apresenta conceitos iniciais sobre testes de API e automação de testes com Postman. Ele discute APIs, REST, requests e respostas HTTP, e como criar e rodar testes no Postman usando asserções e bibliotecas como Chai. O documento também fornece links para recursos adicionais sobre o tópico.

1. Automação de
Testes de API
com Postman

2. Exploring Path
Apresentação01
Conceitos iniciais
Testes, Automação de Teste, API, RESTful…
Utilizando o Postman
Reconhecimento, Rodando a primeira Requisição
Criando e Rodando nossos Testes
Aba “Test”, Bibliotecas e Assertion Functions
02
03
04
05
06
Perguntas ???
Temas futuros
Acrescentando nossos testes no Build: Github + Travis CI + Postman + Heroku

3. Lucas Amaral
Quality Assurance
Portfólio GC/Adtalem
Brasil
Desde 2008 na estrada: Dev (-),
Requisitos (++), QA (++)

4. Testes e Automação
Put things together

5. Conceitos Iniciais
Definindo o essencial
A atividade de teste é o processo de executar um
programa com a intenção de descobrir ERROS.01
Atividades voltadas para planejamento,
preparação e avaliação de produtos de software
e produtos de trabalho relacionados a fim de
determinar se elas satisfazem os requisitos
especificados e demonstrar que estão aptas para
sua finalidade
02
Utilização de software para desempenhar
ou dar suporte às atividades de teste
Automação
03
Testes e
Automação

6. QA >>> Testes
Antes de gerar flames sobre o conceito de testes exposto, lembre-se que QA >>> Testes
A propósito, leia ESTE ARTIGO
Flame alert!

7. API, REST e RESTful
Put things together

8. APIApplication Programming
Interface
API é um conjunto de rotinas e padrões de programação para acesso a um
aplicativo de software ou plataforma baseado na Web
APIs entregam funcionalidades a websites;
APIs estão por trás das aplicações/softwares online (SaaS);
APIs suportam as aplicações móveis (Apps Mobile);
“A API é o livro de regras, que estabelece os padrões de comunicação que
poderão ser usados naquela interação. Se eu quero programar uma aplicação
que use os dados do Twitter, eu devo usar o livro de regras conforme definido
pelo Twitter, pela API do Twitter.” (Sensedia)
Resumindo

9. APIApplication Programming
Interface
• REST é um Modelo arquitetural Funciona em cima do HTTP através de
requisições simples. Suporta várias representações: XML, JSON, YML.
RESTful são Aplicações que seguem o padrão REST
• SOAP é um Protocolo que utiliza HTTP para fazer chamadas no padrão RPC:
Remote Procedure Call. Suporta somente XML
REST (RESTful) x SOAP
Veja mais sobre os níveis de maturidade de Richardson

10. Requests e Responses
A ideia por trás: Client/Server
Server retorna Response para
Client
Realiza validações, autenticação,
…
Server processa a Request
Envia uma requisição ao Server
informando a ação desejada e
parâmetros necessários/desejados.
Client faz uma Request

11. HTTP
Request
Composição básica de
uma Request
GET | POST | PUT | PATCH | DELETE
HEAD | OPTIONS | TRACE | CONNECT
• Verbos ou Métodos HTTP
http://jsonplaceholder.typicode.com/users
• URL (Resource e Parâmetros)
• HEADER
• BODY

12. HTTP
Response
Composição básica de
uma Response
• HEADER
• BODY
1XX: Informacional
2XX: Sucesso na Requisição
3XX: Redirecionamento
4XX: Erro no Cliente
• 401: Unauthorized
• 403: Forbidden
• 404: Not Found
5XX: Erro no Servidor
Mais em: httpstatuses.com
• HTTP Status Codes

13. Requests e Responses
Características de requests e responses
onlinecurl.com
Acessar
http://jsonplaceholder.typicode.com
/users
Digite a URL no campo Verifique o
Resultado
Tanto Request como Response são compostas basicamente pelas seções HEADER e
BODY. Cada uma possui uma série de atributos definidos no momento do desenvolvimento
e que dependem também do resource que está sendo requisitado.
O jsonplaceholder.typicode.com é uma casca de API RESTful para testes

14. RESPONSE HEADER

15. RESPONSE BODY

16. Utilizando o Postman
Put things together

17. POSTMAN
Ambiente completo para
Desenvolvimento de APIs
https://www.getpostman.com

18. Interface do Postman

19. Sidebar
Collections
Folders
Conjunto de Requests
Requests
Mais uma forma de agrupar/organizer Requests
Requests a serem executadas

20. Detalhes da Request
Method, URL, Header, Environment

21. Detalhes da Response
Body, Header

22. Vamos aos
Testes

23. Quando
testamos a
API…
… estamos na parte
intermediária da Pirâmide
de Testes
Leia mais

24. Testes no Postman
Os testes no Postman são escritos em Javascript
Fast, flexible, and lean implementa
tion of core jQuery designed specif
ically for the server.
Cheerio
A modern JavaScript utility library
delivering modularity, performance
& extras
Lodash
JavaScript library of crypto standards
Crypto.js

25. Criando Testes
Aba “Test”, Bibliotecas e Assertion Functions

26. You can simply impress your
audience and add a unique zing
and appeal to your Presentations.
Your Text Here
A aba “Tests”
Nesta aba são escritos todos os testes relacionados à Request em
questão. Cada teste é especificado com a função:
pm.test(testName:String, specFunction:Function):Function

27. Principais
Objetos
Objetos a manipuláveis
nos testes
Link API
pm.response
.code:Number
.reason():Function → String
.headers:HeaderList
.responseTime:Number
.text():Function → String
.json():Function → Object
Objeto Response
request (read-only)
.url:Url
.headers:HeaderList
Objeto Request

28. Assertions
Assertions usando em cima do Objeto
Response usando o .to.have
pm.response.to.have (to.not.have)
.status(code:Number)
.status(reason:String)
.header(key:String)
.header(key:String, optionalValue:String)
.body()
.body(optionalValue:String)
.body(optionalValue:RegExp)
.jsonBody()
.jsonBody(optionalExpectEqual:Object)
.jsonBody(optionalExpectPath:String)
.jsonBody(optionalExpectPath:String,
optionalValue:*)
Funções de Assertion – to.have

29. Assertions
Assertion acerca do Código do
Response usando palavras chave
pm.response.to.be (to.not.be)
.info [1XX status]
.success [2XX status]
.ok [200 status]
.redirection [3XX status]
.clientError [4XX status]
.serverError [5XX status]
.error [4XX or 5XX status]
.accepted [202 status]
.badRequest [400 status]
.unauthorized [401 status]
.forbidden [403 status]
.notFound [404 status]
.rateLimited [429 status]
Funções de Assertion – to.be

30. Assertions
Função de Assertion genérica
utilizando a biblioteca BDD ChaiJS
pm.expect(assertion:*):Function → Assertion
pm.expect(valor).[cadeia].[função].(valor)
Onde essa cadeia é montada e a função é disponível de acordo com o padrã
o da biblioteca ChaiJS
pm.expect(pm.response.json().length).to.equal(9)
pm.expect(pm.response.code).to.not.be.oneOf([300, 400,
500, 100])
Funções de Assertion - pm.expect

31. Rodando Testes
Send e Runner

32. Runner
Executa a chamada de toda uma
Collections rodando os testes e
gerando o Report de testes
Obs: Os testes são executados a cada “Send” de uma request e são exibidos na aba
“Tests Results”

33. Questions?

34. Papo futuro

35. Material
Alguns links relevantes para essa
palestra
• Post da Sensedia sobre Testes de API, Postman e Newman
• https://sensedia.com/blog/apis/realizacao-de-testes-em-api-rest/
• https://sensedia.com/blog/apis/o-que-sao-apis-parte-2-como-uma-api-funcio
na/
• Instalando Node no Windows
• http://nodesource.com/blog/installing-nodejs-tutorial-windows/
• Importante para rodar o Newman
• Documentação Newman
• https://www.npmjs.com/package/newman
• Marvel API
• https://developer.marvel.com/docs
• Mockando uma API
• https://mockaroo.com/
• API do Postman
• https://www.getpostman.com/docs/v6/
• https://www.getpostman.com/docs/v6/postman/scripts/postman_sandbox_a
pi_reference
• Outros resources:
• https://thecuriousdev.org/postman-test-api
• https://www.udemy.com/restful-apis/learn/v4/overview
• http://jsonplaceholder.typicode.com
• http://downloads.sensedia.com/webinar-design-de-apis-restful/
• https://onebitcode.com/api-completa-rails/
• + os links distribuídos pela apresentação

36. Vlw, flws
/doamaral in/lopesdoamaral