HTTP e REST

O tipo de pedido mais corrente: tudo o que fala HTTP, a começar pelas API REST.

Clique com o botão direito na árvore ▸ Adicionar ▸ Pedido HTTP.

Métodos

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS e QUERY.

O URL

O URL aceita {{variables}} em qualquer sítio — esquema, anfitrião, porta, caminho, cadeia de consulta. O valor resolvido é apresentado sob o campo.

Três listas completam o URL:

• os parâmetros de consulta (?key=value);
• os parâmetros de caminho, que substituem os segmentos nomeados do caminho;
• os cabeçalhos.

Cada linha tem uma caixa de verificação para a ativar, um tipo de valor e uma descrição.

O corpo

Quatro famílias:

Tipo	Utilização
Texto	JSON, XML, texto simples — com realce de sintaxe e reformatação
Ficheiro	Envia o conteúdo de um ficheiro do disco
Formulário (multipart/form-data)	Campos nomeados, com ficheiros
x-www-form-urlencoded	Campos nomeados codificados no corpo

Opções

• Tempo limite: em milissegundos, específico deste pedido; na sua ausência, aplica-se o valor global.
• Seguir redirecionamentos: ativado por predefinição. Desative-o para observar o próprio 3xx e o respetivo cabeçalho Location.

A resposta

Estado, tempo, tamanho, cabeçalhos e o corpo apresentado conforme o seu tipo de conteúdo: visualizador JSON recolhível, XML indentado, pré-visualização de imagem, texto simples. O separador de histórico dá acesso às execuções anteriores.

Autenticação

Associe uma rota de autenticação ao pedido para que os cabeçalhos sejam injetados e o token renovado automaticamente. Consulte Autenticação.

Modo servidor

O Restorm também sabe alojar um servidor HTTP, para testar a forma como um cliente o consome — tipicamente o código da sua aplicação, que aponta para localhost durante um ensaio.

Adicione um com Adicionar ▸ Servidor HTTP: fica à escuta em localhost:<port><path> para um par método + caminho e responde com o estado, os cabeçalhos e o corpo que aí configurar. Os outros protocolos alojam-se da mesma maneira — consulte Modo servidor e Simular uma API HTTP.

Fragmentos de código

O separador Code Snippets propõe vinte e quatro linguagens e bibliotecas: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), Node.js nativo, Go, Rust (reqwest), Java (HttpClient, OkHttp), C# (HttpClient), PHP (cURL, Guzzle), Ruby (Net::HTTP, Faraday), Swift (URLSession), Kotlin (OkHttp), Dart, R (httr), PowerShell, Elixir (HTTPoison), Clojure (clj-http).

Importar em vez de escrever

Tem uma especificação OpenAPI, uma coleção Postman, um ficheiro HAR ou um simples comando curl? Ficheiro ▸ Importar reconstrói a árvore por si. Consulte Importação e exportação.