std.http
The std.http module provides functions for making HTTP requests to external services and APIs.
Makes an HTTP GET request to the specified URL.
Parameters:
url: The URL to send the request toheaders (optional): An object containing HTTP headers
Return Type: object with the following properties:
status: HTTP status code (number)statusText: HTTP status message (string)ok: Whether the request was successful (boolean)headers: Response headers (object)text: Response body as text (string)json: Response body parsed as JSON (if applicable)
Example:
use std.http;
// Simple GET request
let response = http.get("https://api.example.com/users");
if (response.ok) {
print(response.json);
} else {
print(`Error: ${response.status} ${response.statusText}`);
}
// GET request with headers
let response = http.get("https://api.example.com/users", {
"Authorization": "Bearer token123",
"Accept": "application/json"
});
post(url: string, body: string, headers?: object)
Makes an HTTP POST request to the specified URL with the given body.
Parameters:
url: The URL to send the request tobody: The request body as a stringheaders (optional): An object containing HTTP headers
Return Type: object (same as get)
Example:
use std.http;
// POST request with JSON body
let response = http.post(
"https://api.example.com/users",
'{"name": "John", "email": "john@example.com"}',
{
"Content-Type": "application/json",
"Authorization": "Bearer token123"
}
);
if (response.ok) {
print(`User created with ID: ${response.json.id}`);
} else {
print(`Error: ${response.status} ${response.statusText}`);
}
put(url: string, body: string, headers?: object)
Makes an HTTP PUT request to the specified URL with the given body.
Parameters:
url: The URL to send the request tobody: The request body as a stringheaders (optional): An object containing HTTP headers
Return Type: object (same as get)
Example:
use std.http;
// PUT request to update a resource
let response = http.put(
"https://api.example.com/users/123",
'{"name": "John Updated", "email": "john.updated@example.com"}',
{
"Content-Type": "application/json",
"Authorization": "Bearer token123"
}
);
if (response.ok) {
print("User updated successfully");
} else {
print(`Error: ${response.status} ${response.statusText}`);
}
Makes an HTTP DELETE request to the specified URL.
Parameters:
url: The URL to send the request toheaders (optional): An object containing HTTP headers
Return Type: object (same as get)
Example:
use std.http;
// DELETE request to remove a resource
let response = http.delete(
"https://api.example.com/users/123",
{
"Authorization": "Bearer token123"
}
);
if (response.ok) {
print("User deleted successfully");
} else {
print(`Error: ${response.status} ${response.statusText}`);
}
patch(url: string, body: string, headers?: object)
Makes an HTTP PATCH request to the specified URL with the given body.
Parameters:
url: The URL to send the request tobody: The request body as a stringheaders (optional): An object containing HTTP headers
Return Type: object (same as get)
Example:
use std.http;
// PATCH request to partially update a resource
let response = http.patch(
"https://api.example.com/users/123",
'{"email": "new.email@example.com"}',
{
"Content-Type": "application/json",
"Authorization": "Bearer token123"
}
);
if (response.ok) {
print("User partially updated successfully");
} else {
print(`Error: ${response.status} ${response.statusText}`);
}
Makes an HTTP HEAD request to the specified URL.
Parameters:
url: The URL to send the request toheaders (optional): An object containing HTTP headers
Return Type: object (same as get, but typically without body content)
Example:
use std.http;
// HEAD request to check if a resource exists
let response = http.head("https://api.example.com/users/123");
if (response.ok) {
print("Resource exists");
print(`Last-Modified: ${response.headers["last-modified"]}`);
} else {
print("Resource not found");
}
Usage Examples
Fetching JSON Data
use std.http;
// Get JSON data from an API
let response = http.get("https://api.example.com/data");
if (response.ok) {
// Access parsed JSON directly
let items = response.json.items;
for (item in items) {
print(`${item.id}: ${item.name}`);
}
} else {
print(`Failed to fetch data: ${response.status}`);
}
Handling Authentication
use std.http;
// Function to make authenticated requests
fn authenticated_request(url, method, body = nil) {
let token = "your-auth-token";
let headers = {
"Authorization": `Bearer ${token}`,
"Content-Type": "application/json"
};
if (method == "GET") {
return http.get(url, headers);
} else if (method == "POST") {
return http.post(url, body, headers);
} else if (method == "PUT") {
return http.put(url, body, headers);
} else if (method == "DELETE") {
return http.delete(url, headers);
}
return nil;
}
// Use the function
let user_data = authenticated_request("https://api.example.com/me", "GET");
print(user_data.json);
Submitting Form Data
use std.http;
// Submit form data
let form_data = 'name=John&email=john@example.com&message=Hello';
let response = http.post(
"https://example.com/contact",
form_data,
{
"Content-Type": "application/x-www-form-urlencoded"
}
);
if (response.ok) {
print("Form submitted successfully");
} else {
print(`Form submission failed: ${response.text}`);
}
