Cliente / testador de API REST

Componha e envie pedidos HTTP com parâmetros de consulta, cabeçalhos, corpos JSON / de formulário e autenticação Basic ou Bearer, depois inspecione o estado, o tempo e as respostas JSON formatadas. Importe um comando cURL existente ou copie de volta o pedido atual como cURL. Prefere construir pedidos reutilizáveis passo a passo? Use o Criador de pedidos HTTP. Veja também a família Ferramentas de API.
Tudo corre localmente no seu navegador. Os pedidos de origem cruzada estão sujeitos à política CORS do servidor de destino — veja a nota abaixo se um pedido falhar.
Cole um comando cURL
Parâmetros de consulta
Cabeçalhos
Corpo
Autorização
Opções
Quando preenchido, o URL do pedido é acrescentado a este prefixo. Útil para servidores bloqueados por CORS.
200
Corpo Cabeçalhos

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
Porque é que um pedido pode falhar: os navegadores bloqueiam leituras de origem cruzada a menos que a API devolva
                                                                Access-Control-Allow-Origin. Se o destino não permitir CORS pode executar um proxy CORS seu e colar o respetivo URL
                                                                no prefixo do proxy acima, ou usar o Conversor de cURL para executar o pedido a partir de um terminal.
                                                                Os corpos de pedido para GET/HEAD são ignorados, e uma ferramenta WebSocket existe à parte no
                                                                Testador WebSocket.


                                                            

                                                                Métodos HTTP explicados
                                                                
O método que escolhe diz ao servidor o que quer que se faça com o URL. Eis o que significa cada um dos sete verbos que esta ferramenta pode enviar:

                                                                
GET — Obter um recurso: uma página web, uma imagem, uma lista de registos. “Dá-me o que está neste URL.” Só de leitura e seguro de repetir, e normalmente não leva corpo de pedido (um corpo num pedido GET, se houver, é ignorado).

                                                                
POST — Envie dados novos para o servidor, normalmente para criar um recurso ou desencadear uma ação — submeter um formulário, carregar um ficheiro, iniciar uma tarefa. A carga viaja no corpo do pedido. POST não é idempotente: enviar o mesmo POST duas vezes pode criar dois registos.

                                                                
PUT — Substitua o recurso inteiro no URL pelo que envia. O corpo tem de conter a versão nova e completa do recurso. PUT é idempotente: repetir o mesmo pedido tem o mesmo efeito que enviá-lo uma vez.

                                                                
PATCH — Altere apenas parte de um recurso. Envia apenas os campos que quer atualizar, p. ex. {"email": "novo@example.com"}, em vez do registo inteiro. Escolha PATCH quando um PUT completo o obrigaria a reenviar campos que não está a tocar.

                                                                
DELETE — Remove o recurso no URL. DELETE é idempotente: apagar algo que já não existe devolve o mesmo resultado (normalmente um 404) e não faz nada duas vezes.

                                                                
HEAD — Tal como GET, mas a resposta contém apenas cabeçalhos — não é enviado nenhum corpo de volta. Use HEAD para verificar se um URL existe, qual o tamanho de um ficheiro (Content-Length), quando foi alterado pela última vez (Last-Modified) ou de que tipo é (Content-Type), sem descarregar a carga completa.

                                                                
OPTIONS — Pergunte ao servidor que métodos e opções são permitidos para um URL, ou desencadeie uma verificação preflight de CORS. Os cabeçalhos da resposta, como Access-Control-Allow-Methods, listam o que é permitido. OPTIONS normalmente não leva corpo; os navegadores costumam enviá-lo automaticamente antes de um POST/PUT/PATCH/DELETE de origem cruzada.

                                                                
Fácil de confundir: HEAD vs GET — o pedido é idêntico, mas HEAD não devolve corpo. PUT vs PATCH — PUT substitui o recurso inteiro; PATCH aplica uma atualização parcial apenas dos campos que envia.