Single-use ticket for clients that cannot send an Authorization header (native EventSource). TTL 30 000 ms.

POST 
/v1/stream/tickets

Single-use ticket for clients that cannot send an Authorization header (native EventSource). TTL 30 000 ms.

Request

Responses

201

Ticket.

401

UNAUTHENTICATED, TOKEN_INVALID (details.expectedShard = 1 when the native-auth block hash is not a shard-1 block), TOKEN_EXPIRED, CHALLENGE_INVALID, API_KEY_INVALID, STREAM_TICKET_INVALID, ASSIGN_PROOF_REQUIRED, ASSIGN_PROOF_INVALID.

403

FORBIDDEN, ORIGIN_NOT_ALLOWED, API_KEY_SCOPE, ACCOUNT_SUSPENDED, LEASE_INVALID, RECEIVER_NOT_ALLOWED, SENDER_NOT_AUTHORIZED, DEPLOY_NOT_ALLOWED, FREE_FLOW_BARRED.

429

RATE_LIMITED, GAS_BUDGET_EXCEEDED, HOURLY_BURN_EXCEEDED, TOO_MANY_IN_FLIGHT, QUOTA_EXHAUSTED (the latter without Retry-After; details.reason = CAP_REACHED_PAYG_OFF | PAYG_ESCROW_EMPTY).

Response Headers

Retry-After

Seconds (HTTP standard). Millisecond precision is in details.retryAfterMs of the problem body.

RateLimit-Limit

Requests (or RU on the relay path) allowed in the current window.

RateLimit-Remaining

Remaining units in the current window.

RateLimit-Reset

Seconds until the window resets (IETF RateLimit header fields).