Installation

Quick Start with HTTL

Install HTTL

Download the latest version of HTTL from the Visual Studio Marketplace

npm install httl-cli -g

Create .httl file

Create a new file with a .httl extension.

Write a query

Basic

basic.httl

get https://httpbin.org/anything

Advanced

advanced.httl

@base: https://reqres.in/api

# Getting a bearer token
post /login {
  email: "eve.holt@reqres.in",
  password: "cityslicka",
}
as auth # Save the json response body to the variable auth

# Set a global Authorization header which will be used in all requests below.
# Also we can use dot notation to access the properties of the response body.
Authorization: Bearer {auth.token}

# Create a new user
post /users {
  name: "rob",
  job: "engineer",
}
as new_user # save the response to the variable new_user

# Update the user
put /users/{new_user.id} {
  name: "Robert",
  job: "CEO",
}

# Delete the user
delete /users/{new_user.id}
assert {
  status: 204,
  headers: {
    "Content-Length": "0",
  }
}

You are good to go! Run the query

Click the Run button to execute your query.

Alternatively, you can use the shortcut keys Ctrl|Cmd + Enter, or press F5.

httl get https://httl.dev/api/users

For VS Code only

Additionally, you can use the Quick Run panel to execute your query. The query text is saved in the current workspace, so you can run it again at any time.