1. O Que E uma API REST
REST (Representational State Transfer) e um estilo arquitetural para servicos web que utiliza o protocolo HTTP para comunicacao entre cliente e servidor. Uma API REST expoe recursos identificados por URLs e permite operacoes sobre eles por meio dos metodos HTTP padrao.
APIs REST sao o padrao dominante no desenvolvimento web moderno. Praticamente todo servico digital — redes sociais, gateways de pagamento, plataformas de dados — oferece uma API REST para integracao. Saber testar essas APIs e uma habilidade fundamental para desenvolvedores, analistas e times de QA.
2. Metodos HTTP e Seus Usos
Cada metodo HTTP tem uma semantica especifica que define o tipo de operacao realizada sobre o recurso:
- GET: recupera um recurso ou lista de recursos. Nao deve ter side effects (operacao idempotente e segura).
- POST: cria um novo recurso. O body da requisicao contem os dados do novo item.
- PUT: substitui completamente um recurso existente. Requer o envio de todos os campos.
- PATCH: atualiza parcialmente um recurso. Envia apenas os campos que devem ser alterados.
- DELETE: remove um recurso identificado pela URL.
3. Headers e Autenticacao
Headers HTTP permitem passar metadados junto com a requisicao. Os mais comuns em APIs REST incluem:
- Content-Type: indica o formato do body (ex: application/json).
- Authorization: porta tokens de autenticacao, como Bearer tokens JWT ou API keys.
- Accept: informa ao servidor qual formato de resposta o cliente aceita.
- X-API-Key: header customizado comum em APIs que usam chaves de acesso simples.
"Nosso cliente REST permite adicionar quantos headers forem necessarios, tornando simples testar APIs autenticadas com Bearer tokens ou API keys."
4. Codigos de Status HTTP
Os codigos de status HTTP indicam o resultado da requisicao e sao agrupados por faixa:
- 2xx (Sucesso): 200 OK, 201 Created, 204 No Content.
- 3xx (Redirecionamento): 301 Moved Permanently, 302 Found.
- 4xx (Erro do cliente): 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found.
- 5xx (Erro do servidor): 500 Internal Server Error, 503 Service Unavailable.
5. CORS e Limitacoes do Navegador
CORS (Cross-Origin Resource Sharing) e um mecanismo de seguranca dos navegadores que bloqueia requisicoes a dominios diferentes do da pagina atual, a menos que o servidor explicitamente permita. Isso pode ser um obstaculo ao testar APIs de terceiros diretamente no navegador.
Se voce receber um erro de CORS ao usar esta ferramenta, o servidor da API nao esta configurado para aceitar requisicoes do dominio chipak.tools. Nesse caso, considere usar um proxy ou testar localmente via curl ou ferramentas desktop.
6. Perguntas Frequentes
Os dados enviados sao armazenados?
Nao. As requisicoes sao feitas diretamente do seu navegador para o servidor da API. O historico e armazenado apenas localmente no seu dispositivo (localStorage) e pode ser apagado a qualquer momento.
Posso enviar autenticacao Bearer?
Sim. Adicione um header com chave Authorization e valor Bearer seu-token. A ferramenta envia os headers exatamente como configurados.
Por que a requisicao falhou com erro de rede?
As causas mais comuns sao: URL incorreta, servidor offline, bloqueio de CORS ou falta de conexao com a internet. Verifique o console do navegador (F12) para detalhes.
A ferramenta suporta upload de arquivos?
Atualmente a ferramenta suporta apenas bodies no formato texto/JSON. Upload de arquivos via multipart/form-data nao e suportado nesta versao.