Integrate Seamward

REST ingestion API

Send observation batches without the Node collector.

Advanced integration

Prefer the Node collector when it supports your runtime. A direct REST client must reproduce the versioned envelope, redaction, batching, and authentication contract correctly.

Endpoint

Send batches to the versioned ingestion endpoint.

Submit a bounded batch to the configured Seamward ingest endpoint over HTTPS. Local development may use loopback HTTP; remote endpoints must use HTTPS.

Authentication

Use the backend-only secret ingest token.

Send the secret ingest token as a bearer credential from a trusted backend. The token authorizes observation writes for its application environment and must never be exposed to a browser.

Request body

Construct a valid observation batch.

Use envelope version 0.1.
Send the Source and Integration keys for routing.
Include transport, contract fingerprint, structural shape, outcome, and correlation metadata.
Exclude raw payload values and credential headers.

Responses

Handle accepted, rejected, and rate-limited batches.

Treat accepted batches as queued evidence, validate 4xx responses before retrying, respect rate-limit guidance, and retry temporary 5xx failures with bounded backoff.