API Reference

Welcome to the internal routing and gateway documentation for the FirstNewL environment. This gateway primarily handles multiplexed gRPC streams for backend microservices.

Authentication Required
All gRPC calls and REST fallbacks require a valid mTLS certificate or a Bearer token in the authorization header. Unauthenticated requests will be dropped at the edge layer.

gRPC Services Definition

The gateway exposes the following services via HTTP/2. Use the appropriate proto files to generate your client stubs.

gRPC /APIv1/StreamData Bidirectional data stream

Message Structure

Field Type Description
session_id string Unique connection identifier.
payload bytes Encrypted protobuf payload.

Proto Example

rpc StreamData(stream DataReq) returns (stream DataRes) {} message DataReq { string session_id = 1; bytes payload = 2; }
gRPC /API/TelemetrySync Client telemetry upload

Used by legacy clients to sync metrics. Expects unary call.

Field Type Description
client_version string Must be >= 2.0.0

REST Fallback Endpoints

Used strictly for load balancer health checks. Do not use for data transfer.

GET /healthz Liveness probe
{ "status": "ok", "uptime": "14d 2h 11m", "active_streams": "hidden" }