EPCIS

Capture EPCIS 2.0 events.

The EPCIS 2.0 Capture interface. Accepts an EPCISDocument, an EPCISQueryDocument, a bare event, or a bare array of events as JSON-LD. Each event is validated, its EPCs resolved to passports, and stored.

Responds 202 Accepted with a captureJobId — poll GET /api/v1/epcis/capture/{id} for the per-event outcome.

EPCIS capture is a paid add-on; a tenant without it gets 403 epcis_capture_not_available. Counts as one v1 write. Idempotent: send an Idempotency-Key header, and each event's own EPCIS eventID is also deduped.

post/api/v1/epcis/capture

Request

  • Base URL: https://app.tracepass.eu
  • URL: https://app.tracepass.eu/api/v1/epcis/capture
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.tracepass.eu/api/oauth/authorize, token URL https://app.tracepass.eu/api/oauth/token, scopes: passports:write)

Headers

Idempotency-Keystring

Stripe-style idempotency key. A replay with the same key and body returns the cached 202 without re-capturing.

Response

Capture job accepted.

captureJobIdstring

Poll GET /api/v1/epcis/capture/{id} with this id.

status'success' | 'failed'
eventCountinteger

Events found in the submitted payload.

capturedCountinteger

Events actually stored (after idempotency dedup).

Changes

No recorded changes to this operation across all 1 revision of this API.