web-url-build Edge Function — Web Search

web-url-build — Build a URL from parts

Programmatically construct URLs from a base, path, query parameters (with array support), and hash fragment.

---

API

POST /api/web-url-build

Request body

Field	Type	Required	Default	Description
base	string	Yes	—	Base URL
options.path	string	No	—	Path to append
options.query	object	No	—	Query params; arrays become repeated keys
options.hash	string	No	—	Hash fragment (with or without #)
options.trailingSlash	boolean	No	false	Append trailing slash

Success response (200)

{
  "success": true,
  "data": {
    "url": "https://example.com/search?q=hello&tag=a&tag=b#results",
    "queryString": "?q=hello&tag=a&tag=b"
  }
}

Error responses

Code	HTTP	When
INVALID_INPUT	400	Missing or invalid base
INTERNAL_ERROR	500	Invalid URL or unexpected error

---

Usage

cURL

curl -X POST "$FUNCTION_URL" \
  -H "Content-Type: application/json" \
  -d '{"base": "https://example.com", "options": {"path": "/search", "query": {"q": "hello", "tag": ["a","b"]}}}'

Direct import

import { webUrlBuild } from '@aerostack/functions/web-url-build';

const result = webUrlBuild({
  base: 'https://api.example.com',
  options: { path: '/v1/users', query: { page: 2, limit: 25 } },
});
console.log(result.url); // https://api.example.com/v1/users?page=2&limit=25

---

Use Cases

• Constructing paginated API URLs dynamically in server-side code
• Building share links with UTM tracking parameters
• Generating signed or parameterized webhook callback URLs