Server Source code Package
Express
Turn-key HTTP event collection server with Express.js. Handles JSON POST events, pixel tracking (GET), CORS, and health checks.
Features
- Standalone or embedded: Start server automatically or integrate with existing Express app
- CORS support: Configurable cross-origin resource sharing
- Pixel tracking: 1x1 transparent GIF for GET requests
- Health checks: Built-in
/healthand/readyendpoints
Where This Fits
The Express Source is a server source in the walkerOS flow:
It receives events via HTTP (POST/GET) and forwards them to configured destinations.
Installation
Loading...
Quick start
- Integrated
- Bundled
Add to your flow.json sources:
Loading...
Server sources require platform-specific handlers. For containerized deployments, see Docker →.
Configuration
| Setting | Type | Default | Description |
|---|---|---|---|
port | number | - | Port to listen on. If not set, runs in app-only mode |
path | string | /collect | Event collection endpoint path |
cors | boolean | object | true | CORS configuration |
status | boolean | true | Enable health check endpoints |
HTTP methods
| Method | Endpoint | Description |
|---|---|---|
| POST | /collect | JSON event ingestion |
| GET | /collect | Pixel tracking (returns 1x1 GIF) |
| OPTIONS | /collect | CORS preflight |
| GET | /health | Liveness check |
| GET | /ready | Readiness check |
Ingest Metadata
Extract request metadata (IP, user agent, headers) and forward it through the pipeline to transformers and destinations.
Loading...
Available Ingest Paths
| Path | Description |
|---|---|
ip | Client IP address |
headers.* | HTTP headers (user-agent, origin, referer, etc.) |
protocol | Request protocol (http/https) |
method | HTTP method (GET, POST, etc.) |
hostname | Request hostname |
url | Full request URL |
Advanced Mapping
Use walkerOS mapping features for complex extraction:
Loading...
Example request
Loading...
💡 Need Professional Support?
Need professional support with your walkerOS implementation? Check out our services.