TracePass
Loslegen
EPCIS 2.0

EPCIS-Ereignisse abfragen

Durchsuchen Sie Ihre erfassten Lieferketten-Ereignisse mit EPCIS-2.0-Query-Parametern. Acht werden unterstützt: EQ_bizStep, EQ_disposition, EQ_eventType, MATCH_epc, EQ_bizLocation, EQ_readPoint, GE_eventTime und LT_eventTime. EQ_bizStep, EQ_disposition und MATCH_epc akzeptieren mit | getrennte Werte, um mehrere Alternativen zu treffen (EQ_bizStep=shipping|receiving); die übrigen Parameter nehmen einen einzelnen Wert. Der Abgleich erfolgt exakt gegen den Wert in der erfassten Form: Ein mit der Kurzform shipping erfasstes Event wird über die CBV-URI-Form nicht gefunden und umgekehrt. Jeder andere Parameter liefert 400, statt stillschweigend ignoriert zu werden — ein Tippfehler scheitert also sichtbar, statt Ihre Ergebnismenge zu erweitern.

GET/api/v1/epcis/events
OpenAPI 3.1 herunterladen
GET/api/v1/epcis/events

EPCIS-Ereignisse abfragen

Durchsuchen Sie Ihre erfassten Lieferketten-Ereignisse mit EPCIS-2.0-Query-Parametern. Acht werden unterstützt: EQ_bizStep, EQ_disposition, EQ_eventType, MATCH_epc, EQ_bizLocation, EQ_readPoint, GE_eventTime und LT_eventTime. EQ_bizStep, EQ_disposition und MATCH_epc akzeptieren mit | getrennte Werte, um mehrere Alternativen zu treffen (EQ_bizStep=shipping|receiving); die übrigen Parameter nehmen einen einzelnen Wert. Der Abgleich erfolgt exakt gegen den Wert in der erfassten Form: Ein mit der Kurzform shipping erfasstes Event wird über die CBV-URI-Form nicht gefunden und umgekehrt. Jeder andere Parameter liefert 400, statt stillschweigend ignoriert zu werden — ein Tippfehler scheitert also sichtbar, statt Ihre Ergebnismenge zu erweitern.

Die Ergebnisse kommen als standardkonformes EPCISQueryDocument zurück (Content-Type: application/ld+json), neueste zuerst, und enthalten ausschließlich Ereignisse, die Ihr eigener Workspace erfasst und freigegeben hat. Eine Antwort ist auf 1000 Ereignisse begrenzt; gab es mehr, wird X-TracePass-Result-Truncated: true gesetzt — grenzen Sie den Zeitraum mit GE_eventTime / LT_eventTime ein, um seitenweise zu blättern. Zählt als ein Lesevorgang.

Tarif-Gate: EPCIS-Abfragen sind in jedem Tarif enthalten, auch in Free. Der 403-epcis_query_not_available-Pfad ist nur auf Workspaces erreichbar, in denen der Support EPCIS abgeschaltet hat. Die Abfrage ist ein Lesezugriff und funktioniert daher auch, wenn die Zahlung überfällig, unbezahlt oder das Abonnement gekündigt ist. EPCIS-Abfragen werden auf Anfrage aktiviert; solange sie nicht aktiviert sind, liefert der Endpoint 503 {"error":"epcis_query_node_unavailable"} — wenden Sie sich an den Support, um sie zu aktivieren.

Query-Parameter

  • EQ_bizStep

    string

    Standard-EPCIS-Query-Parameter — matcht Events, deren bizStep dem angegebenen CBV-Wert entspricht (z. B. shipping, receiving); mehrere Werte mit | trennen, um einen beliebigen davon zu matchen. TracePass parst den Parameter und wendet ihn auf den eigenen Event-Speicher Ihres Workspaces an — ein leerer Wert oder ein nicht unterstützter Parameter liefert 400.

  • GE_eventTime

    string (ISO 8601)

    Standard-EPCIS-Query-Parameter — matcht Events, deren eventTime größer oder gleich dem angegebenen Zeitstempel ist. Mit LT_eventTime für ein Zeitfenster kombinieren. Ein Wert, der sich nicht als Datum auslesen lässt, liefert 400.

  • MATCH_epc

    string

    Standard-EPCIS-Query-Parameter — matcht Events, deren epcList den angegebenen EPC enthält (eine TracePass-Pass-Digital-Link-URI); mehrere EPCs mit | trennen, um einen beliebigen davon zu matchen.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Anfrage

# All shipping events for one passport in a time window
curl -sS -G https://app.tracepass.eu/api/v1/epcis/events \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  --data-urlencode "EQ_bizStep=shipping" \
  --data-urlencode "GE_eventTime=2026-01-01T00:00:00.000Z" \
  --data-urlencode "LT_eventTime=2026-06-01T00:00:00.000Z" \
  --data-urlencode "MATCH_epc=https://id.tracepass.eu/p/01/04012345000016/21/BP-48V-100-000001"

Antwort

{
  "@context": "https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld",
  "type": "EPCISQueryDocument",
  "schemaVersion": "2.0",
  "creationDate": "2026-05-09T12:00:00.000Z",
  "epcisBody": {
    "queryResults": {
      "resultsBody": {
        "eventList": [
          {
            "type": "ObjectEvent",
            "eventID": "ni:///sha-256;9f86d0...?ver=CBV2.0",
            "eventTime": "2026-05-09T11:58:00.000Z",
            "eventTimeZoneOffset": "+02:00",
            "epcList": ["https://id.tracepass.eu/p/01/04012345000016/21/BP-48V-100-000001"],
            "action": "OBSERVE",
            "bizStep": "shipping"
          }
        ]
      }
    }
  }
}

Verwandte Endpoints