Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Tutorial 9: HTTP Client (httpx-style)

Juglans provides a full-featured HTTP client library inspired by Python’s httpx. Import it via libs: ["http"].

This tutorial is a cookbook — feel free to skim it for the verbs you need. The next tutorial (the full project) wires this together with everything else.

Basic Requests

GET

libs: ["http"]

[users]: http.get(url="https://api.example.com/users")

Access response fields:

libs: ["http"]

[r]: http.get(url="https://api.example.com/users")
[show]: print(message=output.json)
[r] -> [show]

POST with JSON

libs: ["http"]

[create]: http.post(url="https://api.example.com/users", json='{"name": "Alice", "age": 30}')

Query Parameters

Pass params as a JSON object. They are appended to the URL automatically:

libs: ["http"]

[search]: http.get(url="https://api.example.com/search", params='{"q": "juglans", "page": 1, "limit": 20}')

This sends a request to https://api.example.com/search?q=juglans&page=1&limit=20.

Authentication

Bearer Token

libs: ["http"]

[data]: http.get(url="https://api.example.com/me", auth="Bearer sk-xxx-your-token")

Basic Auth

libs: ["http"]

[data]: http.get(url="https://api.example.com/admin", auth="admin:password123")

Custom Headers

libs: ["http"]

[r]: http.get(url="https://api.example.com/data", headers='{"X-API-Key": "abc123", "Accept": "application/json"}')

Form Data

URL-encoded form submission:

libs: ["http"]

[login]: http.post(url="https://example.com/login", data='{"username": "admin", "password": "secret"}')

File Upload

Multipart file upload:

libs: ["http"]

[upload]: http.post(url="https://example.com/upload", files='{"document": "/path/to/report.pdf"}')

Timeout

Set request timeout in seconds:

libs: ["http"]

[slow_api]: http.get(url="https://slow-api.example.com/data", timeout=60)

Redirect Control

Disable automatic redirect following:

libs: ["http"]

[check]: http.head(url="https://example.com/short-link", follow_redirects=false)

Cookies

libs: ["http"]

[r]: http.get(url="https://example.com/dashboard", cookies='{"session": "abc123", "lang": "en"}')

Response Format

All HTTP functions return a response object with these fields:

FieldTypeDescription
status_codenumberHTTP status code (200, 404, etc.)
headersobjectResponse headers
jsonanyParsed JSON body (null if not JSON)
textstringRaw response body as text
urlstringFinal URL (after redirects)
is_successbooleantrue if status is 200-299
elapsednumberRequest duration in seconds
content_typestringResponse content-type header

Using http_request() Directly

You can also use the http_request() builtin without the stdlib wrapper:

[r]: http_request(url="https://example.com/api", method="OPTIONS", headers='{"Origin": "https://app.com"}')

All HTTP Methods

libs: ["http"]

[g]: http.get(url="https://httpbin.org/get")
[p]: http.post(url="https://httpbin.org/post", json='{"key": "value"}')
[u]: http.put(url="https://httpbin.org/put", json='{"key": "updated"}')
[a]: http.patch(url="https://httpbin.org/patch", json='{"key": "patched"}')
[d]: http.delete(url="https://httpbin.org/delete")
[h]: http.head(url="https://httpbin.org/get")
[o]: http.options(url="https://httpbin.org/get")

Next: Full Project: AI Assistant — combines AI chat, branching, prompts, composition, error handling, and HTTP into one deployable bot.