Getting Started
Get up and running with Norn in just a few minutes.
Installation
Install Norn from the VS Code Marketplace:
- Open VS Code
- Go to Extensions (
Cmd+Shift+XorCtrl+Shift+X) - Search for "Norn"
- Click Install
Or install from the command line:
shell
code --install-extension Norn-PeterKrustanov.norn Your First Request
Create a new file called hello.norn and add:
.norn
GET https://jsonplaceholder.typicode.com/posts/1 Click the Send Request CodeLens above the request, or run Norn: Send Request from the Command Palette.
The response will appear in the Response Panel on the right.
Adding Headers and Body
Add headers directly below the request line:
.norn
POST https://jsonplaceholder.typicode.com/posts
Content-Type: application/json
{
"title": "Hello World",
"body": "This is my first post",
"userId": 1
} Using Variables
Define variables with var and reference them with {{name}}:
.norn
var baseUrl = https://jsonplaceholder.typicode.com
GET {{baseUrl}}/posts/1 Next Steps
- Use API Definitions - Reuse endpoints and header groups from
.nornapifiles - Add SQL Operations - Run named queries and commands from
.nornsqlfiles - Learn about Sequences - Chain multiple requests together
- Explore Advanced Features - Use conditionals, imports, scripts, retries, and JSON data
- Learn the VS Code Features - Use CodeLens, Test Explorer, coverage, and TLS settings
- Add Assertions - Validate your API responses
- Set up Environments - Manage dev/staging/prod configs