Bom dia a todos!
Pessoal, queria agradecer a todos que compareceram ontem no 2 DevQA Night!
Como havia falado que iria passar o documento para vocs segue em anexo minha apresentao.
A parte do Postman como foi demostrado na prtica coloquei alguns prints.
Caso algum tenha alguma dvida fiquem vontade para perguntar!
Testando sua API com o Postman
Larissa Myamoto Sena
API
O que
Application Programming Interface -> traduo para o portugus "Interface de Programao de Aplicativos". a interface entre dois programas (plataformas) diferentes de modo que um se comunique com o outro. Uma forma que terceiros disponibilizam uma interface para que outras pessoas consumem os seus servios.
um conjunto de padres de programao que roda por trs de tudo, muito utilizado em aplicativos e plataformas baseados na web.
Na prtica, uma API simplesmente a exposio de uma srie de ferramentas, mtodos de programao e protocolos, com o objetivo de facilitar a programao de uma aplicao.
Exemplo: Pagamento Online (PayPal, PagSeguro, Moip, Bcash > PayU, Mercado Pago) / Google Maps / Logar, compartilhar, curtir pelo Facebook / Plataforma de comrcio eletrnico (Marketplaces) / Slack.
Vantagens
1. Comunicao entre plataformas diferentes;
1. Entregam funcionalidades a websites;
1. Esto por trs das aplicaes / softwares online (SaaS Software as a Service);
1. Suportam aplicaes mveis (Apps Mobile);
1. Facilidade na utilizao (principalmente para o consumidor e para a empresa que deseja que o seu servio seja utilizado);
1. A economia que gerada atravs da API Marketplace (mais poder financeiro);
1. User Experience invisvel para o usurio final;
Como funciona
**Exemplo do garom com o cliente e cozinha.
Requisies
Para que uma requisio seja vlida, deve ter um formato especfico. O protocolo usado nas requisies o HTTP (HyperText Transfer Protocol).
Quando acessa um site que tem http:// no comeo, est dizendo ao seu navegador para usar esse protocolo ao carregar o site.
A requisio deve ser composta por 4 partes:
1. URL (Uniform Resource Locator);
1. Mtodo;
1. Header;
1. Body.
URL
o endereo que deve ser acessado.
Esse endereo conhecido como o endpoint em que os recursos estaro disponveis.
Mtodo
Esse o verbo que voc usar para interagir com o recurso.
Os mais comuns so:
1. GET, que pede ao servidor o recurso;
1. POST, que pede ao servidor que crie um recurso novo;
1. PUT, que pede ao servidor a atualizao ou edio de um recurso.
1. DELETE, que pede ao servidor que apague um recurso;
Dependendo das permisses do cliente ou do tipo de API, nem sempre possvel apagar ou editar recursos, por exemplo.
Portanto, cada mtodo vlido s em certos casos, e suas aplicaes esto descritas no conjunto de regras (na Documentao) da API.
Header
O Header contm uma lista de detalhes sobre como o cliente quer que a mensagem seja interpretada. Os diferentes servidores ou APIs podem aceitar diferentes headers.
Pode ser um metadata (informao) sobre a requisio (ex: Content-Type).
Pode ser um header customizado.
Body
Aqui vo todos os parmetros que tornam cada requisio diferente entre si, so os detalhes (os dados em si).
Ao invs de ir criando no recurso (header) muito mais fcil adicionar informaes e detalhes no body.
Esse um exemplo que facilita na criao de recursos.
Respostas do Servidor
parecido com a requisio, composto por:
1. Cdigos Http:
1. 1xx: Informaes gerais;
1. 2xx: Sucesso na requisio e na resposta;
1. 3xx: Redirecionamento para outra URL;
1. 4xx: Erro (por parte do cliente);
1. 5xx: Erro (por parte do servidor).
1. Header;
1. Body.
Quais testes se aplicam na API
1. Mudando informaes do header;
1. Mudando informaes no body;
**Exemplo: Cadastro de cliente:
1. Campos em brancos;
1. E-mail invlido;
1. Tipo de cliente diferente;
1. CPF invlido;
1. RG com letras;
1. Data de nascimento invlida;
Postman
uma aplicao para testar APIs! Principalmente enquanto est implementando e depois que foi implementado manter a API funcionando.
gratuito para baixar (possui verso paga > extenso time).
Possui para Chrome e Mac.
Possui integraes com outras ferramentas: Swagger, RAML, Load Impact, Jenkins, cURL, etc.
Como testar com o Postman
1. Onde
1. Como
1. Linguagem
1. Vantagens
Rodar testes automatizados
1. Onde
1. Como
1. Vantagens
Abs!
Testando sua API
com o Postman.pdf
Testando sua API com o Postman
Larissa Myamoto Sena
API
O que
Application Programming Interface -> traduo para o portugus "Interface de Programao de Aplicativos". a
interface entre dois programas (plataformas) diferentes de modo que um se comunique com o outro. Uma forma que
terceiros disponibilizam uma interface para que outras pessoas consumem os seus servios.
um conjunto de padres de programao que roda por trs de tudo, muito utilizado em aplicativos e plataformas
baseados na web.
Na prtica, uma API simplesmente a exposio de uma srie de ferramentas, mtodos de programao e protocolos,
com o objetivo de facilitar a programao de uma aplicao.
Exemplo: Pagamento Online (PayPal, PagSeguro, Moip, Bcash > PayU, Mercado Pago) / Google Maps / Logar,
compartilhar, curtir pelo Facebook / Plataforma de comrcio eletrnico (Marketplaces) / Slack.
Vantagens
Comunicao entre plataformas diferentes;
Entregam funcionalidades a websites;
Esto por trs das aplicaes/softwares online (SaaS Software as a Service);
Suportam aplicaes mveis (Apps Mobile);
Facilidade na utilizao (principalmente para o consumidor e para a empresa que deseja que o seu servio seja
utilizado);
A economia que gerada atravs da API Marketplace (mais poder financeiro);
User Experience invisvel para o usurio final;
Como funciona
**Exemplo do garom com o cliente e cozinha.
Requisies
Para que uma requisio seja vlida, deve ter um formato especfico. O protocolo usado nas requisies o HTTP
(HyperText Transfer Protocol).
Quando acessa um site que tem http:// no comeo, est dizendo ao seu navegador para usar esse protocolo ao
carregar o site.
A requisio deve ser composta por 4 partes:
URL (Uniform Resource Locator);
Mtodo;
Header;
Body.
URL
o endereo que deve ser acessado.
Esse endereo conhecido como o endpoint em que os recursos estaro disponveis.
Mtodo
Esse o verbo que voc usar para interagir com o recurso.
Os mais comuns so:
GET, que pede ao servidor o recurso;
POST, que pede ao servidor que crie um recurso novo;
PUT, que pede ao servidor a atualizao ou edio de um recurso.
DELETE, que pede ao servidor que apague um recurso;
Dependendo das permisses do cliente ou do tipo de API, nem sempre possvel apagar ou editar recursos, por
exemplo.
Portanto, cada mtodo vlido s em certos casos, e suas aplicaes esto descritas no conjunto de regras (na
Documentao) da API.
Header
O Header contm uma lista de detalhes sobre como o cliente quer que a mensagem seja interpretada. Os diferentes
servidores ou APIs podem aceitar diferentes headers.
Pode ser um metadata (informao) sobre a requisio (ex: Content-Type).
Pode ser um header customizado.
Body
Aqui vo todos os parmetros que tornam cada requisio diferente entre si, so os detalhes (os dados em si).
Ao invs de ir criando no recurso (header) muito mais fcil adicionar informaes e detalhes no body.
Esse um exemplo que facilita na criao de recursos.
Respostas do Servidor
parecido com a requisio, composto por:
Cdigos Http:
1xx: Informaes gerais;
2xx: Sucesso na requisio e na resposta;
3xx: Redirecionamento para outra URL;
4xx: Erro (por parte do cliente);
5xx: Erro (por parte do servidor).
Header;
Body.
Quais testes se aplicam na API
Mudando informaes do header;
Mudando informaes no body;
**Exemplo: Cadastro de cliente:
Campos em brancos;
E-mail invlido;
Tipo de cliente diferente;
CPF invlido;
RG com letras;
Data de nascimento invlida;
Postman
uma aplicao para testar APIs! Principalmente enquanto est implementando e depois que foi implementado
manter a API funcionando.
gratuito para baixar (possui verso paga > extenso time).
Possui para Chrome e Mac.
Possui integraes com outras ferramentas: Swagger, RAML, Load Impact, Jenkins, cURL, etc.
Como testar com o Postman
Onde
Como
Linguagem
Vantagens
Rodar testes automatizados
Onde
Como
Vantagens
Testando sua API
com o Postman.pptx
Testando sua api com o postman
Larissa Myamoto sena
Apresentao
Cursando Sistemas de Informao na FIAP
Tcnico em Informtica para Internet
Analista de testes
API
Interface de Programao de Aplicativos
Disponibiliza servios para consumi
