Pular para o conteúdo
fetchpier.comFetchpier Docs

Requisições e o formato .http

Cada requisição é um único arquivo .http que usa sintaxe HTTP padrão mais um pequeno conjunto de extensões prefixadas por comentários. Como o formato é texto plano, o mesmo arquivo é legível em qualquer editor e revisável em um diff.

# @id 9e3a4f72-1234-4abc-9def-0123456789ab
# @rawSubtype: json


# @pre-request-script
# fp.environment.set('token', 'abc')
# @end-script


# @settings
# httpVersion: auto
# verifySsl: true
# followRedirects: true
# maxRedirects: 5
# @end-settings


POST {{baseUrl}}/api/users
Content-Type: application/json


{ "name": "Juan" }

Elementos-chave:

  • Placeholders {{variable}} na URL, cabeçalhos, body e campos de formulário são resolvidos contra o ambiente ativo combinado com mutações de script em andamento.
  • ### é o separador de requisições, mas o Fetchpier mantém uma requisição por arquivo: se um arquivo tiver várias, abre e executa só a primeira. Veja Compatibilidade com outras ferramentas .http.
  • # @id <uuid> identifica a requisição por um UUID estável entre renames, então os registros de histórico continuam apontando para a origem certa mesmo se você mover o arquivo.
  • # @rawSubtype: declara o subtipo do body (json, xml, javascript, text, html) para realce de sintaxe e defaults de Content-Type.
  • # @pre-request-script … # @end-script e # @post-response-script … # @end-script carregam os scripts do usuário como linhas prefixadas por comentários, então o arquivo continua .http válido.
  • # @settings … # @end-settings carrega overrides HTTP por requisição.
  • # @disable-cookie-jar marca uma requisição que deve ignorar o cookie jar neste envio.
  • # @auth … # @end-auth persiste o esquema de autenticação da requisição (tipo e mapeamento de campos) para que sobreviva a um salvar / reabrir. O esquema ativo também é materializado na requisição executável como um cabeçalho padrão — ou um parâmetro de query inicial — então o arquivo continua enviando a auth ao ser aberto em outra ferramenta .http; None não escreve bloco nem entrada materializada. Um bloco malformado, incluindo um sem a linha de fechamento, é reportado e ignorado, e a requisição ainda carrega e continua executável, sem auth.

Para a referência completa de sintaxe, veja Formato .http.