0xDocs 0x.limo

Docs / REST API

Networking

Generated reference for the 3 /v1/net operations of the 0x REST API.

Generated from steamworks sg-backend/openapi.yaml at build 3a4a58e45c+dirty. Do not edit by hand.

Errors are {"error": "..."} with the status (errors); limits are in rate limits.

MethodPathAuthSummary
GET/v1/net/configBearer tokenNetworking CA
POST/v1/net/reportBearer tokenOpt-in aggregate path telemetry
POST/v1/net/certBearer tokenCertify the caller's key:

#GET /v1/net/config

Networking CA (hex DER), relays [{id, addr, region, weight, full}] from the relay registry, direct allowed, v (relay-list version; changes are pushed as {type: net_config, v}), telemetry (reports accepted)

Auth: Bearer token: Authorization: Bearer <access token> (authentication).

StatusResponse
200OK
bash
curl -s "https://api.0x.limo/v1/net/config" \
  -H "Authorization: Bearer $ZEROX_TOKEN"

#POST /v1/net/report

Opt-in aggregate path telemetry (SG_TELEMETRY): {session, counters: {direct, relay, fallback, webrtc, upgrade_attempts, upgrades, direct_failed, c_100..c_inf}, relay_rtt_ms: {relay: ms}}, cumulative per session; the server adds deltas

Auth: Bearer token: Authorization: Bearer <access token> (authentication).

StatusResponse
200OK
400Bad session, unknown counter, value out of range, or a counter went down
403Telemetry disabled
bash
curl -s -X POST "https://api.0x.limo/v1/net/report" \
  -H "Authorization: Bearer $ZEROX_TOKEN"

#POST /v1/net/cert

Certify the caller's key: {spki: hex DER} → {cert, ca, expires} (24 h, s<steamid>.peer.0x1)

Auth: Bearer token: Authorization: Bearer <access token> (authentication).

StatusResponse
200OK
400Bad key
bash
curl -s -X POST "https://api.0x.limo/v1/net/cert" \
  -H "Authorization: Bearer $ZEROX_TOKEN"