Regional API edge

This host is one edge node of the Appreg Gateway pool. It terminates TLS, applies routing rules and forwards requests to the appropriate upstream service. It does not serve application content directly.

TLS termination

TLS 1.2 and 1.3 with automated certificate renewal. HTTP requests are redirected to HTTPS.

Request routing

Path- and header-based routing to upstream pools, with health checks and passive failover.

Response caching

Cacheable upstream responses are held at the edge and revalidated with conditional requests.

Quick start

Every request must carry a project key in the X-Api-Key header. Keys are issued per project and are scoped to a single region.

curl -sS https://gateway.appregvps.org/v1/health \
  -H "X-Api-Key: $APPREG_KEY"

A healthy edge node replies with the node identifier and the current pool revision:

{
  "status": "ok",
  "region": "eu-central",
  "revision": "2026.08.3",
  "uptime_s": 1216840
}

Endpoints in brief

Method	Path	Purpose
GET	`/v1/health`	Node liveness and revision
GET	`/v1/regions`	List reachable regions
POST	`/v1/route`	Resolve a route for a request descriptor
GET	`/v1/usage`	Request counters for the current period

Full parameter reference, error codes and rate limits are in the documentation.

Support

Operational questions go to ops@appregvps.org. Include the X-Request-Id response header from the affected request — it identifies the edge node and the upstream attempt chain.